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TECHNIQUES FOR PERMITTING ACCESS ACROSS A 
CONTEXT BARRIER IN A SMALL FOOTPRINT DEVICE 
USING GLOBAL DATA STRUCTURES 



CROSS-REFERENCES TO RELATED APPLICATIONS 
This application is related to U.S. Patent Application Serial Number 08/839,621 
filed April 15, 1997, entitled "VIRTUAL MACHINE WITH SECURELY 
DISTRIBUTED BYTE CODE VERIFICATION", in the name of inventors Moshe 
5 Levy and Judy Schwabe (Docket No. 50253-221/P3263), which application is 
incorporated herein by reference in its oitirety. 

This application is related to U.S. Patent Application Serial Number 09/235,158 
filed January 22, 1999, entitled 'TECHNIQUES FOR IMPLEMENTING SECURITY 
ON A SMALL FOOTPRINT DEVICE USING A CONTEXT BARRIER", in the name 
10 of inventors Joshua Susser, Mitchel B. Butlor, and Andy Streich, (Docket No. 50253- 
2 1 6/P3708), which application is incorporated herein by reference in its entirety. 

This application is related to U.S. Patent Application Serial Number 09/235,157 
filed January 22, 1999, entiUed "TECHNIQUES FOR PERMirnNG ACCESS 
ACROSS A CONTEXT BARRIER ON A SMALL FOOTPRINT DEVICE USING 
15 AN ENTRY POINT OBJECT", in the name of inventors Joshua Susser, Mitchel B. 
Butler, and Andy Streich, OX)cket No. 50253*2 17/P3709), which ^plication is 
incorporated herein by reference in its entirety. 

This application is related to \JS, Patent Application Serial Number 09/235,155 
filed January 22, 1999, entifled "TECHNIQUES FOR PERMnTING ACCESS 
20 ACROSS A CONTEXT BARRIER ON A SMALL FOOTPRINT DEVICE USING 
RUN TIME ENVIRONMENT PRIVILEGES", in the name of inventore Joshua Susser, 
Mitchel B. Butler, and Andy Streich, (Docket No. 50253-218/P3710), which ^plication 
is incorporated herein by reference in its entirety* 

This application is related to US. Patent Applicsrfion Serial Number 09/235,159 
25 filed Januaiy 22, 1999, entiUed 'TECHNIQUES FOR PERMITnNG ACCESS 
ACROSS A CONTEXT BARRIER IN A SMALL FOOTPRINT USING SHARED 
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OBJECT INTERFACES"* in the name of inventors Joshua Susser» Mitdiel B. Butler, 
and Andy Streich, Pocket No. S02S3-22Q/P3712), which application is incorporated 
herein by reference in its entirety. 

BACKGROUND OF THE INVENTION 

Field of the Invention 

The invention relates to computer security and more particularly to techniques 
for implementing a security on small footprint devices^ such as smart cards. 

Description of Related Art 

A number of object oriented programming languages are well known in the art 
Examples of these include the C-h- language and the Smalltalk language. 

Another such object oriented language is the JAVA^ language. This language 
is described in the book Java^ Lan^ge Specification , by James Gosling et al. and 
published by Addison- Wesley. This work is incorporated herein by reference in its 
entirety. The JAVA^ language is particularly well suited to run on a Java^ Virtual 
Machine. Such a machine is described in the book Java^ Virtual Machine 
Specification , by Tim Lindhohn and Frank Yellin which is also published by Addison- 
Wesley and which is also incorporated harein by reference in its entirety. 

A number of small footprint devices are also well known in the art. These 
include smart cards, cellular telephones, and various other small or miniature devices. 

Smart cards are similar in size and shape to a credit card but contain, typically, 
data processing capabilities within the card (e.g. a processor or logic performing 
processing functions) and a set of contacts through which programs, data and other 
communications with the smart card may be achieved. Typically, the set of contacts 
includes a power source connection and a return as well as a clock input, a reset input 
and a data port through which data communications can be achieved. 

Information can be written to a smart card and retrieved from a smart card using 
a card acceptance device. A card acceptance device is typically a peripheral attached to 
a host computer and contains a card port» such as a slot, in to which a smart card can be 
inserted. Once inserted, contacts or brushes fipom a connector press against the $ur&ce 
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connection area on the smart card to provide power and to permit communications with 

I 

the processor and memory typically found on a smart card. 

Smart cards and card acceptance devices (CADs) are the subject of extensive 
standardization efforts, e.g. ISO 7816. 
S The use of firewalls to sq>arate authorized fiom unaufliorized users is well 

known in the network environment. For example, such a firewall is disclosed in U.S. 
Patent j^plication Serial No. 09/203,719, filed December 1, 1998 and entitled 
"AUTHENTICATED FIREWALL TUNNELLING FRAMEWORK" in the name of 
inventor David Brownell (Docket No. S043S-023/P2789yTJC), which implication is 
1 0 incorporated herein by reference in its entirety. 

A subset of die full Java^ platform capabilities has been defined for small 
footprint devices, such as smart cards. This subset is called the Java Card^ platform. 
The uses of the Java Card^ platform are described in the following publications. 

JAVA CARD™ 2.0 - LANGUAGE SUBSET AND VIRTUAL MACHINE 
15 SPECIFICATION; 

JAVA CARD"^ 2.1 - APPLICATION PROGRAMMING INTERFACES; 
JAVA CARD"^ 2.0 - PROGRAMMING CONCEPTS; 
JAVA CARD'^ APPLET DEVELOPER'S GUIDE. 
These publications are incorporated herein by reference in dieir entirety. 
20 A working draft of ISO 7816 - Part 1 1 has been circulated for comment That 

draft specifies standards for pemutdng separate execution contexts to operate on a smart 
card. A copy of that workii^ draft is hereby incorporated by reference in its entirety. 

The notion of an execution context is well known in computer science. 
Generally speaking, the use of multiple execution contexts in a computing environment 
25 provides a way to separate or isolate different program modules or processes fiom one 
another, so that each can operate without undue interference from the othas. 
Interactions -if any-* between different contexts are deliberate rather than accidental, 
and are carefully controlled so as to preserve the integrity of each context. An example 
of multiple contexts is seen in larger hardware devices, such as mainframes, where a 
30 plurality of virtual machines may be defined, each such virtual machine having its own 
execution context Another example is seen in U.S. Patent No. S,802,S 19 in the name of 



wo 00/45262 



PCT/USOO/01234 



4 

inventor De Jong, which describes the use of multiple execution contexts on a smart 
card. It will be appreciated by those of skill irt the art that a computing environment 
which provides multiple execution contexts also needs to provide a mechanism for 
associating any given executing code widi its conresponding context 

S Also well known is the notion of a currait context. Certain computing 

environments that support multiple contexts will, at any given time, treat one cont^ in 
particular as an active focus of computation. The context can be referred to as the 
"current context" When the current context changes, so that some other context 
becomes the current context, a **context switdi** is said to occur. As will be an>reciated 

10 by those of skill in the ait, these computing enviromnents provide medbanisms for 
keeping track of which context is the current one and for facilitating context switching. 

In the prior art, in the world of small foo^rint devices, and particularly in the 
world of smart cards, there was no inter-operation between contexts operating on the 
small footprint devices. Each context operated totally sq)arately and coidd oporate or 

1 5 malfunction within its context space without affecting other Applications or processes in 
a different context. 

One layer of security protection utilized by the Java^ platform is commonly 
referred to as a sandbox model Untrusted code is placed into a ''sandbox** where it can 
"play" safely without doing any damage to the "real world" or Mi Java^ environment 
20 In such an environment, Java^ applets don't conmiunicate, but each has its own name 
space. 

Some smart card operating systems don't permit execution contexts to 
communicate directly, but do pexmit communications through an operating system, or 
through a server. 

25 The Problems 

A number of problems exist when trying to place computer programs and other 

information on a small footprint device. One of the compelling problems is the 

existence of very limited memory space. This requires often extraordinary efforts to 

provide needed functionality within the memory space. 
30 A second problem associated with small footprint devices is the fact that 

different small footprint device manufacturers can utilize different operating systems. 
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As a result* applications developed for one operating system are not necessarily portable 
to small footprint devices manufactured by a difreiCTt manu&cturer. 

If programs from more than one source of programs (manufacturer or vendor) 
are to be applied to a single small footprint device, security becomes a factor as one 
S attempts to avoid comiption of existing programs and data when a new program is 
loaded on to the smaU foo^rint device. The same concern mists when one wishes to 
prevent a hacker or a malicious person from accessing programs and data. 

It is clear that small foo^rint devices such as smart cards don*t have the 
resources necessary to implement separate virtual machines. Neverdidess, it is 
10 desirable to maintain strict security between separate execution contexts. 

In the past, security was provided by loading only applications from the same 
source or from a known trusted source onto a smart card or odier small footprint device. 

Accordingly, it would be desirable to allow object-oriented interactioii between 
selected execution contexts only in safe ways via fast efficient peer to peer 
15 communications which do not impose undue burdens on the pro g r am mer but facilitate 
dynamic loading of applets written at different times by untiusted sources. 

SUMMARY OF THE DsP/ENTION 
The invention is directed to providing a context barrier (sometimes referred to as 
a firewall) for providing separation and isolation of one context from another and to 
20 provide controlled access across the barrier when that is needed. 

In accordance with the invention, two execution contexts, e.g. each containing 
one or more applets, ruxming in the same logical (i.e., virtual or real) machine, protected 
from each other, can share information in a controlled, secure way, using language 
mechanisms, such as object-oriented language mechanisms. Security can be, for 
25 example, object by object. Thus, a method in a first execution context can access a first 
object A in a second execution context, but not a second object B in the second 
execution context on a selective basis. 

In accordance with one exemplary embodiment, an enhanced Java^ Virtual 
Machine (VM) provides certain run-time checks of attempted access across execution 
30 contexts in the VM. Checks can be ^tomatic by the VM or coded by the programmer 
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with support from the VM. This can be done using language-level conununication 
mechanisms. In this way, one can express object access across execution contexts in the 
same way as other object accesses using the language are made. These run-time checks 
provide a second dimension of defense/security beyond that which the Java^ language 

5 and platform already provide. 

These mechanisms provide protection against, e.g., security holes due to 
programming bugs (such as declaring a datum "public" (global) when it shouldn't be 
accessible to all contexts). They also allow fme-grain control of sharing (such as 
selection of objects to share and applets to share to). 

10 The invention is also directed to computer program products and carrier waves 

related to the other aspects of the invention. 

The foregoing and other features, aspects and advantages of the present 
invention will become more apparent from the following detailed description of the 
present invention when taken in conjunction with the accompanying drawings. 

is BRIEF DESCRIPTION OF THE DRAWINGS 

The features and advantages of the present invention will be apparent from the 
following description in which: 

Figure 1 is an illustration of a computer equipped with a card acceptance device 
and of a smart card for use with the card acceptance device. 
20 Figure 2 is an illustration of a computer eqmpped with a card acceptance device 

connected to a networic. 

Figure 3 is an exemplary hardware architecture of a small footprint device* such 
as a smart card, of the prior art. 

Figure 4 illustrates objects being accessed by principals as done in the prior ait. 
25 Figure 5 is an exemplary security model which can be used in e)q)laining the 

various embodiments of the invention* 

Figure 6 is a blodc diagram showing sqsaration of execution contexts by a 
firewall or context banier in accordance with one aspect of the invcntioa 

Figure 7 is a representation of a software architecture usefiil in carrying out the 
30 invention. 



wo 00/45262 PCrAJSOO/01234 

7 

Figure 8 is a flow chart of a security enforcement process implementing a 
firewall in accordance with one aspect of the invention. 

Figure 9 is a block diagram showing object access across a firewall in 
accordance with one aspect of the invention. 
5 Figure 10 is a block diagram showing cascaded object access aooss a firewall. 

Figure 1 1 is a flow chart of a process for permitting access by a principal in one 
context across a firewall into another context 

Figure 12 is a block diagram illustrating the use of an entry point object to 
permit access across a firewall. 
10 Figure 13 is a block diagram illustrating the use of a global data structure such 

as an array for access across a firewall. 

Figure 14 is a block diagram illustrating the use of a supercontext to permit 
access across a firewall. 

Figure 15 is a block diagram illustrating the use of shareable inter&ce objects to 
IS permit access across a firewall. 

Figure 16 is a flow chart of a security ^forcement process permitting access 
across a firewall. 

Figure 17 is the flow chart of Figure 16 showing details of block 1620. 
Figure 18 is a flow chart showing an exemplary implementation of block 1629 
20 of Figure 17. 

NOTATIONS AND NOMENCLATURE 
The detailed descriptions which follow may be presented in tismis of program 
procedures executed on a computer or network of computers. These procedural 
descriptions and represwitations are the means used by those skilled in the art to most 
25 effectively convey the substance of their work to others skilled in the art. 

A procedure is here, and g^erally, conceived to be a self-consistent sequence of 
steps leading to a desired result. These steps are those requiring physical manipulations 
of physical quantities. Usually, though not necessarily, these quantities take the form of 
electrical or magnetic signals capable of being stored, transferred, combined, compared, 
30 and otherwise manipulated. It proves convenient at times, principally for reasons of 
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common usage, to refer to these signals as bits, values, elements, symbols, characters, 
terms, numbers, or the like. It should be noted, however, that all of these and similar 
terns are to be associated with the appropriate physical quantities and are merely 
convenient labels applied to these quantities. 

5 Furtha, the manipulations performed are often referred to in tenns, such as 

adding or comparing, which are commonly associated with mental operations performed 
by a human operator. No such capability of a human operator is necessary, or desirable 
in most cases, in any of the operations described herein which form part of the present 
invention; the operations are machine operations. Useful machines for performing the 

10 operation of the present invention include genera] purpose digital computers or other 
computational devices. 

The present invention also relates to apparatus for performing these operations. 
This apparatus may be specially coitstmcted for the required purpose or it may comprise 
a general purpose computer as selectively activated or reconfigured by a computer 

IS program stored in the computer. The procedures presented herein are not inherently 
related to a particular computer or other apparatus. Various general purpose machines 
may be used with programs written in accordance with the teachings hcrm^ or it may 
prove more convenient to construct more .specialized apparatus to perform the required 
method steps. The required stmcture for a variety of tihese machines will- appear fiom 

20 the description given. 

DETAILED DESCRIPTION 
Attached as an Appendix to this specification is an unpublished draft of a 
document entiUed JAVA CARD RUNTIME ENVIRONMENT 2.1 SPECIFICATION. 
This draft document, which provides ftirther detailed description of spedfic 
25 embodiments of the invention, is incorporated in its entirety as an integral part of the 
present specification. 

Although the inventive techniques are described hereinafter in the context of a 
smart card example, the example is merely illustrative and shouldn't limit the scope of 
the invention. 



wo 00/4S2IS2 PCTAJSOO/01234 

9 

Figure 1 is an illustration of a computer 120 equipped with a card accq)tancc 
device 110 and a smart card 100 for use with the card acceptance device 110. In 
operation, the smart card 100 is inserted into card acceptance device 110 and powa* and 
data connections applied through a set of contacts 105 accessible at the surface of the 

5 smart card 100. When the card is inserted, mating contacts from the card acceptance 
device 110 interconnect with the surface contacts 105 to power-up the card and pemiit 
communications widi die onboard processor and monory storage. 

Figure 2 is an illustration of a computer equipped with a card acceptance device, 
such as 120 in Figure 1, connected to a network 200. Also connected to a network arc a 

10 plurality of other computing devices, such as server 210. It is possible to load data aad 
software onto a smart card over the netwoik 200 using card equipped device 120. 
Downloads of this nature can include applets or other programs to be loaded onto a 
smart card as well as digital cash and other information used in accordance wiA a 
variety of electronic commerce and other applications. The instructions and data used to 

15 control processing elements of the card accqjtance device and of the smart card may be 
stored in volatile or non-volatile memory or may be received directly over a 
communications link, e.g., as a carrier wave containing the instructions and/or data. 
Further, for example, the networic can be a LAN or a WAN such as the Internet or other 
network. 

20 Figure 3 is an exemplary hardware architecture of a small footprint device, such 

as a smart card, of the prior art As shown in Figure 3, a processor 300 interconnects 
mth primary storage 310 which may include read only memoiy 315 and/or random 
access memory 316. The processor also connects with a secondary storage 320 such as 
EEPROM and with an input/output 330, such as a s^al port. One can see the small 

2S footprint devices of this nature can be very simple. 

Figure 4 illustrates objects being accessed by prirwipals as done in the prior art. 
As shown in Figure 4, physical device 400, such as the small footprint device may have 
contained within it one or more processing machines (virtual or physical) which are 
running an execution context 420. The execution context may be, for example, a 

30 context associated with a particular applet One or more principals 430 (e.g., applets or 
applications) in the execution context may seek to access other objects within the 
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execution context. As long as the access occurs within the execution context, the 
accesses will be permitted and everything will function normally. 

Figure 5 is an exemplary security model which can be used in explaining the 
various embodiments of the invention. It is just one of many models which might be 

5 utilized but is a convenient model for this purpose. In tiiis model, a principal 
(sometimes called entity) 500 proposes to take an action 510 on an object, such as object 
520. Security checks may be imposed on the principal, on the object, and/or on the 
action proposed to be taken. 

In Figure 5, two types of objects are shown on which action may be taken by a 

10 principal. These include data objects, (e.g. datal and data2 (520, 520*)) and entity 530. 
A principal may operate or attempt to operate on any of these objects. 

While data is passive, an entity 530 is active. The diagram line from Principal to 
an active entity is also labeled "action," but this could be a more sophisticated and 
arbitrarily complex action, such as making a function or method call or sending a 

15 message as compared wifli action on a data object. As with data, a security check 
enforced by the operating system may use the identity of the principal, the identity of the 
entity, and/or the type of action. Furthermore, the entity, being active, can perform its 
own additional security checks. These can be as arbitrarily complex as one desires, and 
can make use of the identity of the Principal, the identity of the entity itself, the action, 

20 and/or any other information that is available. 

In an object-oriented system (such as the Java Card^ platform) "objects" are 
typically a combination of data and entity. When a Principal tries to access a field of an 
object, this is a data access--a fairly simple action protected by a fairiy simple security 
check. When a Principal tries to access a method of an object, this is an entity access, 

25 which can be arbitrarily complex both in action and in security check. 

Figure 6 is a block diagram showing separation of execution contexts by a 
fu^ewall or context barrier in accordance vsrith one aspect of the invention. The physical 
device 400 and the machine 410 confespond to the same items shown in Figure 4. An 
execution context 420 shows one principal 430 attempting to access object 440 within 

30 the context. This access would normally succeed. However, execution context 420 also 
shows a principal 630 attempting to access object 640 of execution context 620, across a 
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context barrier 600. Normally, this access would be prohibited as indicated by the X 
636 where the action 635 crosses the context barrier 600. 

Figure 7 is a representation of a software architecture useful in carrying out the 
invention. This software architecture is shown as a run time environment 700. An 

S operating system 710 for the small footprint device is commordy used. A virtual 
machine 720, in an exemplary embodiment of the invention, is implemented over the 
operating system. The virtual madiine could be a Java Card^ virtual machine or other 
virtual machine. The capabilities of a standard virtual machine can be expanded to 
provide the additional fimctionality described herein or the functionality can be provided 

10 as separate modules. The virtual machine 720 may include an intopreter or native 
implementation 730 which provides access to a run time system 740. The run time 
system includes object system 750 for managing the objects of an object oriented 
inqilementation. Three contexts, 760, 770 and 780, are shown. Each context is 
separated fix>m the other by a context barrier (sometimes refored to as a firewall) 

IS between the execution contexts. Context 760 is, in one specific embodiment, a 
supercontext. That is, context 760 has privileges and cq)abilitie$ not available to 
subordinate contexts 770 and 780, potentially including privileges to create entry point 
objects or global data structures, and to access objects in subordinate contexts 770 and 
780. 

20 Every object is associated with one particular context. That context is said to 

own each object that is associated with it. The runtime system 740 provides a means for 
uniquely identifying contexts, and a means for specifying and identifying the currmtly 
executing context The object system 750 provides a mechanism for associating objects 
with their owning contexts. 

25 For example, the runtime 740 can identify contexts with a unique luune, and 

correspondingly the object system 750 can associate objects with that context by 
recording the context's name in the object's header. Information in the object's header 
cannot be accessed by programs written in the object-oriented language, but is only 
available to the virtual machine 720 itself. Alternately, the runtime system 740 can 

30 identify contexts by dividing the memory space into separate regions, each for a 
particular context, and conespondingly the object system 750 can associate objects with 
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that context by allocating the objecfs storage in that context's memory space. 

Figure 8 is a flow chart of a security enforcement process implementing a 
context barrier in accordance with one aspect of the invention. When a principal 
invokes an action on an object (800) a check is made to detennine whether the object is 

S within the context of the principal (810). If it is not, the action is disallowed (840). 
Otherwise, the action is permitted (830). This is the simplest form of context barrier or 
firewall. In one specific embodiment the action is disallowed (840) by flirowing a 
security exception if the object is outside of the namespace or the memory space of the 
context requesting access. 

10 Figure 9 is a block diagram showing object access across a firewall in 

accordance with one aspect of the invention. Figure 9 is substantially similar to Figure 
6. However, Figure 9 also shows principal 900 seeking to access Object 910 in order to 
perform action 905 on the object 910. According to the invention, rather than having 
the access blocked by the firewall 600, in the way that action 635 is blocked, action 90S 

15 is permitted to occur across the firewall through access point 920 so that principal 900 
can perform action 905 on object 910 notwithstanding the fact that the principal and the 
object are in difFerait execution contexts. The mechanisms behind access point 920 are 
described below with reference to Figures 12-18. Note that access point 920 can 
coexist with obstructed accesses such as X 636. Thus access point 920 provides fine- 

20 grain control of sharing (object by object security) across context barrier 600. 

When object access 900 is initijUed, the cunrent context setting is context 420. If 
the object 910 is a data object, the action 905 is a simple data access, and no code is 
executed in the second context 620. If the object 910 is an entity object, and the action 
905 results in that objects code being executed, that code is executed in the second 

25 context 620. To execute the code of object 910 in the correct context 620, the virtual 
machine 410 paforms a context switch. The context switch changes the curroit context 
setting to be context 620, and the previous value of the current context s^ng is stored 
so that it can be restored later. From that point on code will execute in the new current 
context. When the action 905 completes, control is returned to the point following 

30 access 900. During the return, the virtual machine 410 must restore the value of the 
current context setting to its previous value. 
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Figure 10 is a block diagram showing cascaded object accesses across a 
firewall Figure 10 shows three execution contexts, 1000, 1010 and 1020. Pxincipal 
1030 in execution context 1 seeks to invoke an action 1035 on object 1050 in execution 
context 2 and does so through access point 1070 in context barrier 600. Object 1050 b 

S execution context 2 has an object access 1040 which seeks to perform an action 1045 on 
the object 1060 in execution context 3. It achieves this by using access point 1080 in 
context bairier 600* separating execution contexts 2 and 3. Object 1050 in execution 
context 2 also has another object access 1090 which invokes an action 1095 on an object 
1099 in tfie same ^ecution context, that is, in execution context 2. Both actions 1035 

10 and 1045 result in context switdies as described in the explanation of ngur But as 
action 1095 does not cross die context barrier, a context switch is not required for its 
execution, and therefore does not occur. 

Figure 1 1 is a flow chart of a process for pennitting access by a principal in one 
context across a firewall into another context. There are essentially three steps to this 

IS process. In execution context 2, an object to be accessed is created and designated as 
shared (1100). In execution context 1, flie principal obtains a referoice to the object in 
execution context 2 (1110). The principal in execution context 1 then invokes an action 
upon die object designated as shared in context 2 (1120). 

With respect to identifying or designating a created object as shareable as 

20 discussed in item 1100 of Figure 11, this can be done, in accordance with a specific 
embodiment of the invention, by including a shareable attribute in the headw of an 
object's representation. Information in an objecfs header cannot be accessed by 
programs written in the object-oriented language, but is only available to the VM itself. 
Obtaining a reference to an object in another context is a special case of 

25 accessing an object in another context A mechanism that provides access to an object 
in another context can make other objects available also. For instance, invoking a 
method on an object in another context may return a reference to a second object in a 
different context An additional mechanism is required to allow an initial reference to 
an object in a diffeimt context to be obtained. In a specific embodiment, references to 

30 certain well-known entiy point objects can be obtained using a public API. Once the 
initial reference to an object in a different context is obtained, further references can be 
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obtained from that object^ and so on. 

There are four general approaches to obtaining information across a context 
banier in accordance with the invention. These approaches can be utilised mdividually 
or in combination in order to access an object across a context banier or to obtain a 
reference of an object to be accessed across a context barrier (1110). These approaches 
aie described in Figures 12-18. 

Figure 12 is a block diagram illustrating the use of entry point objects to permit 
access across a context barrier. As shown in Figure 12, some object 1200 in context 
770 (context 1) desires access to information in supercontext 760. In the ^ecific 
embodiment^ a supercontext 760 contains at least one entry point object 1210. The 
entry point object 1210 can be published as part of a public API, or can be made 
available indirectly through a published API (e.g., in accordance with the mechanisms 
described previously with referoice to Figure 11), so that each context subordinate to 
the supercontext may communicate with the entry point object of the si4>ercontext. (It 
will be appreciated that in other embodiments, entry point objects may be housed by a 
context other than the supercontext.) 

Figure 13 is a block diagram illustrating the use of global data structures to 
permit access across a firewall In this approach, supercontext 760 creates a global data 
structure such as a global array. In the specific embodiment supercontext 760 is the 
only context permitted to create such a global data structure. (It will be i^jpreciated that 
in other embodiments, global data may be housed by a context other than the 
supercontext.) By virtue of its global status, each of the contexts 770 and 780 may read 
and write to the global data structure. Thus, information written into the global data 
structure by one context can be read by anodier context. For example, this mechanism 
can be used to pass binary data or references to objects between contexts. 

Figure 14 is a block diagram illustrating the use of supercontext privil^es to 
permit access across a context barrier. In Figure 14, an object in supercontext 760 seeks 
access to context 780 across the context barrier separating the two. Supercontext 760 
can invoke any of the methods of context 780 and can access any of the data contained 
within context 780, by virtue of the privileges associated with the supercontext. 
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Figure 15 is a block diagram illustrating the use of shareable interface objects to 
permit access across a firewall. A shareable interface defines a s^ of shareable inter&cc 
methods. A shareable inter&ce object is an object that implements at least the set of 
methods defined in a shareable interface. In Figure 15, object 1210 in context 2 (780) 
5 is a shareable interface object. An object access 1200 in another context 770 can invoke 
any of the shareable inter&cc methods on the object 1210 if the principal of the object 
access 1200 is authorized to do so by the object 1210 itself. This authorization is fiirther 
discussed with reference to Figure 18 below. 

It will be q>preciated that a virtual machine consistent with the invention 
10 provides fimctionality beyond that of earlier virtual machines, such as the virtual 
machine described in the Java™ Virtual Machine Specificatioa In particular, 
consistently with the invention, the virtual machine provides fimctionality to implemoit 
or to facilitate a security enforcement process that permits access across a firewall. This 
process is described next with reference to Figures 16-18. Note that it is applicable to 
I S any ^proach for providing access across the firewall, including but not limited to the 
four approaches described with reference to Figures 12*15 above. 

Figure 16 is a flow chart of a security enforcement process pmnitting access 
across a firewall. When a principal attonpts to invoke action on an object 1600, a check 
is made to determine if the <*ject is within the context of flie principal (1610). If it is, 
20 (1610-Y), die action is pCTnitted (1630). If it is not, (1610-N), a check is made to see if 
the action by the principal is permitted on the object (1620). If it is, (1620-Y), the action 
is permitted (1630). If it is not, (1620-N), the action is disallowed. In the specific 
embodiment a security exception is thrown (1640). 

Figure 17 is the flow chart of Figure 16 showing fiirther details of block 1620. 
25 If the object is not within the context of the principal (1610-N), a plurality of tests, 1621, 
1622, 1623... 1629 are undertaken to see if the action by the principal is pennitted on the 
object. These tests can be done by the virtual machine alone or by the virtual machine 
plus the object, in a virtual machine object oriented implementation. If any of the tests 
results in a pass, the action is permitted (1630). However, if all tests result in a negative 
30 determination (162X-No), the action will be disallowed. In a specific embodiment, a. 
security excq>tion will be thrown (1640). These tests relate to the pennitted access 
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discussed in conjunction with Figures 12-15. 

Figure 18 is a flow chart showing an exemplary implementation of block 1629 
of Figure 17 for use with access method described in Figure IS. In a test, such as 829 
or 1629, a virtual machine checks if the object is a shared object 1810. If it is not (1810- 
5 No), the test will fail However, if it is (1810- Yes), the virtual machine will invoke the 
method A on object O (1820), If the method A on object 0 detennines that the principal 
is authorized (1830), the test will be passed (1840) and access permitted. Otherwise, the 
test will fail (1850). This allows the authorization text to be programmed into the code 
ofthe object itself. 

10 Although the invention has been illustrated with respect to a smart card 

implementation, the invention applies to other devices with a small foo^rint, not just to 
smart cards. Devices with a small footprint are generally considered to be those that are 
restricted or limited in memory or in computing power or speed. Such small footprint 
devices may include boundary scan devices, field programmable devices, pagers and 

1 5 cellular phones among many others. 

In general, small footprint devices are resource constrained computational 
devices and systems where secure interoperation of execution contexts is a concern. 
Such small devices impose constraints on the implementation of security measm-es 
because of their limited resources. Because of resource constraints, in a virtual machine 

20 implementation, a single virtual or physical machine must be used as opposed to 
multiple virtual machines. 

The invention may also be applied to devices with larger footprints where the 
characteristics of the invention may prove beneficial. For example, the invenrion may 
prove advantageous when using servlets if there is object sharing between them. Even 

25 some desktop systems may profitably utilize the techniques of the invention. 

While the Java*"^ language and platform are suitable for the invention, any 
language or platform having certain characteristics would be well suited for 
implementing the invention. These characteristics include type safety, pointer safety, 
object-oriented, dynamically linked, and virtual-machine based. Not all of these 

30 characteristics need to be present in a particular implementation. In some embodiments, 
languages or platforms lacking one or more of these characteristics may be utilized. A 
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"viitual machine** could be implemented either in bits (virtual machine) or in silicon 
(real/physical machines). 

Although the invention has been illustrated showing object by object security, 
other approaches, such as class by class security could be utilized. 

Although the present invention has been described and illustrated in detail, it is 
clearly understood that the same is by way of illustration and example only and is not to 
be taken by way of hmitationi the spirit and scope of the present invention being limited 
only by the tenns of the q>pended claims and thmr equivalents. 
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Jtva ^ Card ^ Rootiaie EavinanBat (JCR£) 2.1 Specification 



Preface 



Javam Cardm technology conbloet a portion of the Java prograaimiag language with a nmtime environment 
Qptlmized for anavt cuds and lelaied, snaO««wmory embedded dcvtees. tht goal of Java Cardtedmology ia to 
bring many of the benefiu of Java toftware piognniDung to the rcsowcom^ 

This doeumcot la a ipedfication of the Java Cud Runtime EnvircBtmcnt (JCRE) 2.1. A vendor of a Java Card* 
enabled device providea so inplcroeatation of the JCRE, A JCRE bnplemataiko within die context of thia 
apcdficatten refbn to a vendor't tmplementatiaD of the Java Card Vtmial Macfane (VM), die lava Card 
Appltcaticn Progfamming intcr&ce (API)* er odur oonipcnettS, based on die Java Caid technology 
spodficationiL A Jteftrem /mplcmemation U an Implemcntadon produced by $im bfooiystcma, Inc, Appleii 
written for the lava Caidplatfonn are rcfcR«d to aa Java Caid applets. 



Who Should Use This Specification? 

this ipedficadon U intended to anist JCRE implemcntera in creadng an hnplementBtion, developing a 
specification to extend the Java Card technology spcdficstioni, or tn acadng an extcnnon to die Java Card 
Runtime Environment (JCR£>. thii ipedfication im also intended for Java Card applet developei;^ who want a 
gitatcr uttdostanding of die Java Card technology ipecificatiaoa. 



Before You Read This Specification 

Before reading this guide* you should be fomiliar with the Java proi^amming language, the Java Card 
technology specifications, and smart card technology. A good resource for becoming fomiliar. widi Java 
technology and Java Osid technology is die Sun Microsystcma, he. vcbsUe, located at 
http I //j ava . aim* CO& 



How This Specification Is Organized 

Chapter I , "The Scope and RespooMUllcs of the JCRE," gives an overview of die services requiicd of a 
JCRE iixq))emeoiaiion. 

Chapter l» 'Ufctloie of the Vlrtoal Machine,** defines die tifodme of die Vtatual Machfaie. 
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Java ™ Card w Runtime Eovironment (JCRE) 2.1 Spedftation 

Cluptcr 3, -Applet Ufetoe,- dtfyia the It&tbne of m tpplet 

Chapttr 4, ntulcM ObjtcU^" provides aa overview of cnuuicnt olQCCct. 

Chapter S. "■Sdeetfon," describes how ihe JCRE handles applet sdeedost 

Chapter ^ "Applet IsolaHon and Object Sbariag,** describes applet isolation lod ot^ sharing. 

Chapter 7. nVaosactioas and Atomlelty/ previdea an overview of atomidty disiog tnmsacdonk 

yilJci^^ '^cdonaUtyrwpiifedofa JCRE bui not compl^^^ 

Chapter % «Vlrtaat Machine Toples,** describes viftual machine spedfica. 
Chapter 10. "Appkt InstaUer." provides aa overview of the Applet InoaUer. 

5i;?*?''c"'r.^".^*'***^" the numeric value of oonstsats thatarenot specified in dieyma Card 

Art 2. J jpecijicaHOft* 

Gloaury is a list of words and dusir deBnidons Co assist you in using diis book. . 



Related Documents and Publications 

Referenees to various doaiments or products ere made in diis manual. You should have the following 
dootmenis availaUe: 

m Card 2.0 iMgtagtSubsmm^ OctobetU. 1997. HevtsUm LOFinnl, 

Sun Miaosystcms. inc 

■ Jovtt Card Apptei Devehper's Gtdde, Sun MJcxojyitans, Inc 

" IMJ^MOuSS^^ ^ ^ md Guy L Steele. Addisao-Wesley. 1996, 

Wesley. {996, ISBN 0-201 •«3452*X. 

m The Java Qou UbraHes: An Annomwd Rdkrm Uam Affetl by Pirtridr nnA ttn^n^ ^ y ^ 
Addiseo>Wesley. two volumes, ISBN: 02013 10023 and 03013 10031. 

■ ISO 78 16 Specification Parts t -6. 

m EMV -96 Imegrated Circuit Card Spedfieationibr Payment Systems. 
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Java TV cafd ^ Rvmtme EavironiBem (JCRB) 2. 1 Spceillcatioii 



L Introduction 



The Java Card Runtimo Envrauncm (JCRE) 1 \ contsint ihc iava Card Vbtuai Machine (VM), dte lava Card 
Applicatiaa hogmnmiog biteifica <AP1) danet (and mAmrY-spod^ extcnsionf X and auppon aervioea. 

Tbii doeumcD^ iha ICRE 2.1 Specifieatioii» ipedfiet iha ICRS fUncdooality raquM by tha Java Card 
technology. Any implcmentBiioa of Java Card technology shaU |n«fvide «hia ncoesaary behavior and 
ottvlioQinnti 
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Javn ™ Card «« Runtime Environmem (JCRE) 2. 1 SpeeificattOD 



2. Lifetime ofthe Java Card Vimal Machine 

to* PC « iNortaBtsoa. die lavB Vimul Machiiw nmi at in operating synon process. When the OS nroccu is 
tenninalBd, the Java appttcationt and didr crtjects are automadony dertroyedT 

I? '"7^ of Virtual Machine (VM) is the U&tiine of Ihe card. Most of 

the mfomonoo stored on a c«d ahaU be prewrvtd even what power is rtmoml from the card P^en^ 

Se Ja^ inihmiationlhat is peoistent. 

fte Java Card VM app«rt to rm forever. When power is removed. Ac VM stops <»ty temponrily. MOmi the 
card IS next reset, the VM «am up again and recovers its previous olqea heap 

Aside from its pcnistatt naharc. die lava Card Virtual Machine is just like the Java Virtual Machine. 

The card inidalixadoa time is die dme after masking, and prior to die dme of card perseoaliaatieo and issuance. 
At die time ofcard mituUaanim, die JCRE is inidaUied. The fiameH^fc objects crated hy die JCRE^^te 
die Ufetime of die Virtual Marine. Because die execution lifetime of die V^l^^i^^^^ ^ 
ftamewoit ^« CAD »a»aos of die canl. die lifedmes of c^jecis created hy applets v^ll also span CAD 

when the csrd u removed from die CAD.) Okjecis that have diis property are caUed pertiatem ob|ectt. 
The JCRE implemcnter shall make an otgect pcnisieot when: 

* ^i^^ .regiater meduxi u called. The JCRE stores a reitrenee to die instance of die applet object 
The JCRE ttiiplementer shall ensure diat instances of class applet are patistait 

• ArcftToncetoan<^Ustaredtoa6eldofanyotiierpcnnstentobject« 

requirement stems from die need to preserve die integrity of die JCRE's internal data meturei. 
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3 . Java Card Applet Lifetime 



For ihe puiposei of this ipedficitioo, « J«v8 Card applet*! lifetime begins at the point that it has been eoirectly 
loaded into catd memory, ImM, and otherwise prepared for eaecutioa. (For the rcmatndcr of this specificattoo, 
appltt refen to an applet Mfrtaen for the lava Card platform. ) Applets registered with the Applet . rogiotor 
method extst for die lifetime of die cud The JCR£ interacts with die applet via die ai^tct's public mediods 
iBstaXl, select, deaeleet, and pzoeees . An a^let shall implement the ttadc Install mediod. If die 
inotal 1 mediod is not cnplonented, die applet*! o^ects caraiot be oealed or tnhialUed A iCRE 
implementation shall call an applet** Install, aalect, deaeleet, and prociesa methods as described 
batow. 

When die ^iplet IS installed on the smart eard^ die static inatall mediod is called once by the JCRE for each 
applet fautance created. The JCRE shall not call die applet's constnictor directly. 



3.1 The Method install 

When install is called, no ol^ects of the applet exist The main task of the loo tall meUiod widim die applet 
is to acate an instance of the Applet dass, and to register die inssance. All odicr objects diat die applet will 
need during its lifetime can be cjtated as is feasible. Any other prqarations necessary for the applet to be 
selected and accessed by a CAD also can be done as is feasible. The iaatolX mediod obtains inittaUxsdoa 
parameters fim die oootems of the faiooming byte array parameter. 

Typically, an applet creates various objects, initiaKzes diem widi predefined values, sets some inteinal state 
variables, and calls die Applet . register mediod to specify the AID (applet IDcntificr as defined in ISO 
7816-5) to be tised to sdect it This inttatlatiflo is considered successfol when die call to die 
Applet .register mediod completes without an eaception. The installadon is deemed uasuccessfid if the 
lost el 1 method does not call die Applet . register mediod, or if an caceptioo is dirowa from widihi the 
install method prior to die Applet . register method being called, or if die Applet . register mediod 
throws an exoepttoo. If die tnstalladoo Is unsuocessfol, die JCRE shall pcrfonn all cleanup when it regains 
control That is, all persistent objects shall be returned to die sutfe diey had prior to calling die install 
Ruahod. If the installation is suooessfol, the ICRE can mark die applet u amiable for selecdon. 
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3.2 The Method select 

Applets remain in a suspended state until they are explicidy selected. Selection occurs when the iCR£ reodves 
a SELECT APDU in which the name data matches the AID of the applet Selection causes an applet to beooree 
the cuiraiUy seleded applet 

Prior to calling SELECT, the ICRS dull deselect the previously selected applet The iOXE aSdicala this to dte 
applet by invokiQg the applet's deaelect method. 

The JCRE faifiHins the applet of selectioa by invoidag its select method. 

The applet may decline to be selected by returning f aide from the call to the eelect method or by throwiog 
an execptioit If the applet retums tnte. the actual SELECT APDU command is supplied to die applet in (he 
subsequent call to its proee b a method* so that tht ap^et can examine the APDU content! The a|^et cam 
process the SELECT APDU command exactly (ike h processes any other APDU command, h can respond to 
the SELECT AFDU with dau (see the proceao method for det&Us), or it can flag emrs by throwing an 
xsoexc^tioa with the appropriate SW (returned status word). The SW and optional re^onse data are 
tttumedtedieCAD. 

The Applet . oelect logApplet method shall return «ue when called during the select method. The 
Applet . seleetiB9Applet method wilt continue to return true during the subsequeat pxoeosa method, 
which is called to process the SELECT APDU command. 

If the applet declines to be selected, the JOUB will rensn an APDU response status word of 

X so . s«_APPi^_6ELBcr_rAZUEQ to the CAD. UjpoD seleeiioQ ftilm the JCRE aiate is aet to Mkam that 

no applet is selected. 

After success^] selection, all subsequent APDUs are delivered to the currently selected applet via die proceae 
method. 



33 The Method process 

All APDUs art received by die iCBB, which paaa ao instance of the APDU daaa to the proeaes method of 
the currently sdected applet 

Note A SELECT APDU might cause a change in the currently selected applet prior to dve call to the 
proceee method. 

On norina) rctmn, the JC31E automaticatty ai^e&ds (hi9000 as the co^ 
sent by the applet 

At any time during process, the applet may throw an X80S»teeptien with an apprapriate SW, in whieh ease 
the JCRE catches die excepUm and renmu the SW to die CAD. 

If any other exception is thrown during process* die JCRE catches the exception and reoims the status word 
X8096i6.sir mnoiONHtodieCAD. 
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3.4 The Method deselect 

When ihe iCRC roxives a SEUCT APDU conmaiid b whidi ibe 

JCR£ caU« ihe D£S£UCr inctfiod of the cisitntty lalectcd 

cleanup opcntions that may tx required in order to aUow tomo other applet to execute. 

The wl9t . seiectingAiiplet method shaU raum felse when called during the daaeleet method. 
ExccpttOBS thrown by the dooeleet method are eau«hs by the JCRE, but the applet ia deselected. 



3.5 Power Loss and Reset 

Power loss occurs when the card ia withdrawn from the CAD or If there is aome otha m 
iulurc When power U reapplied to the caid and on Card Reset (warm or oold) 

• Traoalcaiit data is reset Co the defiiult value. 

• The nanaactian in progress. If any, who power was lost (or reset occutred) ia aborted. 

• Hie applet ttiat was selected when power was lost (or reset oecuned) becomes implicitly deselected. (In 
thta case the deaeXeet method is not called.) 

• lftheJCREimplanentsde&ultappletsdectioa(aeepar8gnph5.IXthede&uha|7lctU^^ 
cumnUy selected applet* and that the deftuh a|^lct*a ooleet method U called. Odierwise, the JCRE sat 
its state m nuficate that no applet is selected. 
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4. Transient Objects 



Applets lometimet require ol>|ectt that coaiatn temporary (traniient) data that need not be pmistent across 
CAD sessions, lava Cord does not support the Java keyword tranaleat. However, Java Card tecfaaology 
provides methods to create transient arrays with primitive components or relbences to object . 

The torn ''tnuisient object** is a misnomer. It can be mcorrectly interpreted to mean d&at die ol^ect itself is 
transient However, only the contents of die fields of the objea (exeept for die length field) have a tnnsicnt 
naoffe. As widi any other object in die Java programming language, traosieot objects within die Java Card 
platfimn exist as long as they are referenced ficmn: 

• The stack 

• Local variables 

• A class stabe field 

• A field in another existing object 

A fenuisient object within die lava Card platftarm has the following required behavior: 

• The fields of a transient tibiect shall be eieared to die field's dc&ult value (zero» &lse, or nuU) at die 
occuirence of certain evtota (see below). 

• For security reasons, die fields of a transieot object »hall never be itored in a ''penlstent memory 
technology." Usiog current smart card technology as an example, die contents of transient obfecu can be 
stored in RAM, but never in EEPROM. The pnpose of dits requtremem is to allow transient objects to be 
used to store session keys. 

• Writes to the fields of a tnuisient object diall nm have a perfimnanoe penalty, (Using cunent smart card 
tedmology as an example, die contents of transiem objects can be stored in RAM, while die contents of 
nen-oansieat objects can be stond in EEPROKl Typically, RAM tedmotogy has a much &stcr write cycle 
timedMoEEPROM.) 

• Writes to die fields ofa transient otject shall notbeaCfeeted faiy'*ir8nsaetians.'*T1iat is,ao 
AbortTransaceion will never cause a field faia transient object to be ftstoted ton previous vahie. 

This behavior make transient objects ideal fbr small amounts of temporary applet data ft tt is fiequendy 
modified, but diat neiMi not be preserved acrou CAD or select sessions. 
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4. 1 Events That Clear Transient Objects 

P^nigtent objtctt art used for mMataming $ttaa that ghall be presoved acaroai card rt$eu. When a transient 
ot^cct ii created, one of two evenU ire specified that caw its fields to be de«x«d. CLEAiLON J<£SET 
transient ofcjecta are usod for maintaining nates that diatt be preserved across applet seloctioos, but oot acron 
card resets, CLEAR^0NJ3ESEL£Cr nuient objecu are ined (tn maintaintng iiases that must be ps csc r v cd 
while an applet is tdected* but not acroa applet selectioiu or caxd resets. 

Details of the two clear events are as (bltows: 



• CLEAKwON^R£SET^c otijcct's fields are cleared when die caid is reset. When a card is powered od, 
this also causes a card reset 



NoUl It is oot iieoessary to dew die fields of ttansic&t olgecu before p^ 

Kowcm,U Is neeessary to guarantee d&at die previottiooiiiaiti of inch fiddscaoDOt be recovered oaee 
power Is lost. 

• CLEAIL.OHJ>ESELECr«*lhe object's fidds sre dcaied whencvo any applet is dcsdected. Because a 
card reset hopUdtly desdectt die cunentty idected applet* die fidds of CLEARwOH-OESELECT ot^jests 
are also deared kqr die same events specified to CLEfUCOK.^^ 

The aofoitly selected applet is cxpUddy dcsdected (its deselect method is called) only when a SELECT 
eomoiaad Is processed. The currently selected applet is deselected and dico die fidds of all 
CLEAILOHJ>£SEL£Cr transient ol;)eets are cleared regardless of whedier die SELECT command' 

• Fdla to sdect an applet 

• Sdects a different a^let 

• Resalecta die same applet 
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5. Selection 



Cardj receive requests for service from (he CAD in the form of AJPDUa. The SELECT APDU is used by the 
JCRE todesignitc a atrrtntly ulected applet. Once aelected, ao applet receives all suhsequeDl APDUs until the 
applet becoRiea deseiected. 

There is no curwnUy selected applet when dtha of the following occurs: 

• The card is reset and no applet has been pre-de«gnated as the drfauh applet. 

• A SELECT oommand fills when attempting to select an applet. 



5.1 The Default Applet 

Normally, applets become selected only via a sucoessiul SELECT command. However, seme smart ord CAD 
sppttcations require that there be a default amslet that U implicitly selected after every card met The behavior 

1. After card reset (or power on. which is a form of reset) the JCIlEpalbriRs its in^ 

to sec if its imemtl state indicates that a particular applet is the de&uU applet If so. the iCRE "»*i>*t this 
aiglet (he cutrently selected i^let, and the applet*s aolect method is called. If die applet's select 
method throws an exception or returns false* then die iCRE sets its state to indicate ttiat no applet is 
selected. (The applet's process method is not called during de&ult applet sdeetion because Acre is no 
SELECT APDU.) When a de&ult applet ia selected at card teset, it shaU not require its process 
method to be called. 

2. TlicJCREensuresdarttheATRhasbeenaemaodUiecardisoowreadytoaceeptAPDUc*^^ 

If a defiuilt applet was sucoessAilly sdected, dien APDU commands can be sent direcdy to this applet If a 
defiudt applet waa not selected, dicn only SELECT commands can be processed. 

The mechanism for specifying a default applet is not defined in the Java Caid API 2. t . It is a JCRE 
implementation detail and is left to the individual iCRE implemcntcrs. 
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5.2 SELECT Command Processing 

Ihe SELECT APDU command is used to select an applet Iti befaavior is: 

1. The SELECT APDU is ahrayi prooessed by the JCRE regaidlesa of wbidu If uy. ^>plct is actives 

2, The ICRE scarchea its imonal cable for a maficbing AID. The JCRE ihatl support selecting an applet wheit 
the fiill AID is present to the SELECT coanuod. 

JCRE implemoitas are free to enbanoe their ICRE to suppon other selection oitcrion. An exanple of this 
is sdection via partial AID match as specified in ISO 781M. The specific lequrements are as follows: 

Note ^ An astcritit indicucs Unaiy Mt numbering as in IS078 1 6. Most si^iificant bit « ha. Least simifiamt ' 
bit-bi, 



a) Appld SELECT eoanattdasc8a4WlK00»INS>-0xA4. 

b) Applet SELECT command uses *5ei8clien by DFoaae*.TheRfi»«»^IHh04. 

c) Any other value of PI implies that is not an sppletselecL The APDU is processed by die cuncntly 
selected applet 

d) iCREshaa suppon caMDF name (AID) selection i^P2«%b00003acOO.(M.b3^ 

c) AUodicr partial DP name SELECT eptkas(b3,bi*) are iCRE incrementation dependent 

f) All file control In&nnatien qpdon codes (b4,h3*) shall be supported by die ICRE and interpreted 
and processed by die ^iplet 

3. Ifoo AID match la fbund: 

a. If diere is no currently selected applet die JCRE responds to die SELECT command widi status code 
0x6999 (S W>PPLET.SELECT JFAXLBDX 

h. Otherwise, die SELECT command is forwarded to die currently selected applet's procese method. 
A oontot switdb into the ipplet*s context occurs at this point (The applet context is defined in 
para^aph 6. 1 J.) Appleu may use die SELECT APDU canunand fin* dieir own internal SELECT 
pracening. 

4. If a matching AID is fouod, die JCRE prqpores to select die new applet If diere is an cunently selected 
applet it ia deselected via a call to its deselect mcdiod. A context iwiich into die deselected applet's 
contat oeras at diU point The ICRE c«ntB[t is rcsmred upon exit ftom deaelect. 

5. The ICRE sets die new cuncndy selected applet The new applet is selected via • call to its eelect 
method, and a context switch Into die new applet's context occurs. 

a. If die applet's aslect mediod dirows an exocptioo or returns false, diea ICRE state is set so diat no 
applet is selected. The ICRE responds to die SELECT command widi staha code 0x6999 
^W.APPL£TJ5£LECTJ'AIL£D^ 

. b. The new curatly selected applet's process method is then called widi die SELECT APDU as an 
faiput parsmcter. A context switch .into die applet's contoa occurs. 

Notes ^ 
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tha*i. « miMhing AID «>d the SELECT eomound GriU. ihe JCRE .hny. *ni« Ae wh« .x. vplet is 

d^^^^f^M.t^lT' tl^ «^y.««««««« •PPlei. the JCRE «iU goe* through the proem of 
d«»d«in8 <he applet and *« ideetog ft. RadeetioiiawM Ml. l-vtogthecid too sT^hJJe^wwte it 



5.3 Non-SELECT Command Processing 

When • noB-SHJECT APOU it rmived ind (here is a euiremly seleeud vplet. the JCRE invoke* die 

applet ja»ing A* APDUMap^meter. H.Uaius.s.eonteW 

tt^ switches hwk to *e JOtt eoMext. The JOIE «»d. . itsponse APDU Mid w.it. for Ae ne« 
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6. Applet Isolation and Object Sharing 



Any implememation of the JCRE shall support iiotation of oontcxn and appleu. Isolation means that one applet 
can not access the fields or otjects of an applet in another context unless the other applet cxpUciUy provides an 
tnterfeoe for access. The JCRE mechanisms for applet isolation and ottject sharing art detailed in the sectiona 
below. 



Hie ^pltt fifTwaU widiia Java Card technology is runtime-enforced protection and is separate from die Java 
technology proteaions. The Java laoguagc protections still apply to Java Caid applets. The Java language 
cnswes diat ittong-tyi^ng and piotcctioii atbrihutci arc enforced. 

Applet firewalls are ahways cnftrced in the Java Card VM. They allow the VM to amcmatically perffam 
additional security checks at nmtime. 



6.1.1 Contexts and Context Switching 

Ftfvwalls essentially partition the Java Card platfonm's object system into separate protected otgect spaces 
called conttxM. Ihe firewall is die boundary between one context and another. The JCRE ^1 allocate and 
manage an applet eonuart'kt each applet that is installed on die card. (But see paraipaph 6. 1.1.2 bdow for a 
d is cuB sic p (tf group oantcxts.) 

* In addition, die JCRE mainiaina la own JCH£ eomca, Tliia context is much IIVeo an qiplet context, but it has 
special system prtvilcga so diat it can per&nn operadoas that are denied to applet coatexta 

At any point in time, there is only one acsivt conttxt widiin die VM. (This is called die euFttmly aeiivg 
cofiicif .)*Alt byiecodes diat access objects are chocked at runi/me against die cuntnUy active context bi order to 
detcnniae if die access is allowed. A java . laag . Securi tyExcepcipn is dirown when an access b 
dinllowed. 

WhcD ceitain wcll'<lefined conditions are met during die execution of invoke-<ype bytccodes as described in 
parasf^ 6^.8. die VM pcrfbmua con/cci^ntffcA. The previous context is pushed on an internal VMstack,a 
new context becomes die euirently active context, and die invoked method executes hi this new oontexL l^ion 
exit from thai mediod the VM perfbrms a restoring context switch. The origioal context (of the caller of die 
incdiod) is popped fiom die ABCk and to restoied as die cunently active context Comcxt awi 
ncstel Tliennxhnun depdi depends on die ameuot of VM sock space available. 



6.1 



Applet Firewall 
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Mast method invocations to Java Card technology do not cause a contact switch. Context switches only occur 
dunng invocation of and rehim tan ceitiin methods, as «vtlt as during exception exits from those methods (set 

During A contcxt.switchmg method tnvocmtion, an addhional piece of data. Indicating the cumitly active 
context, is pushed onto the renou stock. This context is restored when die method is exited. 

Further details of eontextt and context switching are provided in lata secdons of diis chapta. 
.6.1.1.1 Group Contexts 

Usually, each instance of a Java Card applet defines a s^arate context. But with Java Card 2. 1 tcchnoiogy, the 
concept of group contexi is introduced. If more than cne applet is contained ta a single Java package, they chatt 
the same context Addidonatly. all tnstaaces of die same applet class share the same context In odier words, 
there Is no firewall between two applet initaBecs in a group context 

The discussion of contexts and context switching ebove in section 6. 1 . 1 assumes that each applet instenoe is 
associated wHh a separate context In Java Card 2.1 technology* contexts aro compared to enfiirce die firewall, 
and die mstanee AJD is pushed onto die stack. Addhionatty* dtis bsppens not only when die eontext switches, 
but also when control switches fitim an otgeet owned by one applet i&stanoe to an object owned by aooditr 
instance widitn the same padcage. 



6. 1 .2 Obj ect Ownership 

When a new object is created, it is associated with d^e curicndy active «atcxt. But dte object is o^ed by die 
applet instance widtin d)e cunently active context when die dbject is tastantiaied. An ob^ is owned by an 
applet bistance, or by the JCRE. 



6.1,3 Object Access 

In general an ol^ect can only be eeeested by its owning context, dut is, when die owning context is die 
cuncntty acdve context The firewall prevents an object from being acGC»ed by aaodter applet in a difietcnt 
context. 

In imptemcntaiion terms, each time an object is accessed, d)e object^a owner context is canpared to die 
currently acdve context If dicse do not match, die access is not perfermed and a fieeuritycxeoption is 

dffOWD. 

An object is accessed when one of die following bytecodes is executed using die o^'ecl's refemoe: 

getflold. putfield* invokevixtual, invokeintorf ace , 
athrow. «T»«load» <T>«atorer arraylength, ehaekeaat* iaataneeof 
<t> refoa to the various types of snay bytecodes, such as baload, aaatore, etc. 

This fist includea any spodai or optimized tonus of diese byteoodes hnplemented in die Java Card VM, such as 
gat£ieVd_b» agacf lold.a.thia,etc 



6.1 A Firewall Protection 

The Java Card firewall provides prelection against die most frequently anticipated security concern: developo 
mistakes and design oversights duit might allow sensidve data to be **leaked" to anodier applet Ao applet may 
be able to obtain sa object reference from a puUtdy accessible location, but if die ol^ect is owned by a 
different applet, die firewall ensures security. 
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J'* *V*5*^^u 2: ' *P««'<'« mtaimum protecii« nquireimnti oTconwiit aiui finwalU becMW 

..iwieqfihebeh«vi«ofoljeci».AM^«idai«piiqwr^^ ^ "»»««»ew «»u ee 

« Sil!f IS!?!!^ **' xUWonal tecurity mechmimii beyond ibose of (be applet ruc>wll. 

«Mj«B a. ttief e mectanima « tn«»p««rt 10 .pplett airf 

6.1.5 Static Fields and Methods 

liAouWtliote Mied ihM ciute. tn OM «MMd by context*, -nme iino nmiinie comexi eheekibu en be 
mvcktd. (Sinaarly, liiwelcesiwetal cmisc* no eamM switch.) 

^^^If^^ ^ ^ "^^y ^ whomever acated diem and 

ttandard ndes apply. If it it neeessafy to share Ihcm aooas muhiple applet eontexis. dieo dicse 

otjectt neod to be 5Aof«oMe Interface Objecu (SIO«). (See pangrapb 6.2.4 bel^.) 

S!i1?""^J?* wnv«»i«id *»va tcehnotogy protections arc still enforced fer static fields and methods. In 
method is peimitted InitaBatiw and ^lecillcs about li^^ 

Optional static access checks 

The iCRE may pa'fonnoptioRa^ funthnc checks that an redundant with the constraims enforced by a verifier. 

when code viotates fiindsmemal language restrictions, suchas w^ngaw^wSs 
mediod uaaodwr class. and rcpoit or odierwise address die violcS^ w™ingapnvaie 



62 Object Access Across Contexts 

l^^^^T^^ •^^l*" ?L? wdiHlefined yet secure medianum. « 

provMod so one context can access an ^ject beloagmg to anodier context 



Utese mechanisms are provided In the Java Card API 2.1 andarediscuned in the following actions: 



• iCRE Entry Point Olijecu 

• Global Arrays 

• JCR£ Privileges 

• Shareable Interiaoes 
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6.2. 1 JCRE Entiy Point Objects 

Seoare computer systems shall have a way for non-privileged user processes (thai are Ksttteted to a subset of 
resources) to request system services performed by privileged **system" routines. 

tfl the Java Card API 2. 1, this u accomplished MskagJOiS Entry Mnt Objeeu. These are dtgeeu owned by the 
JCRfeontext, but tftey have been flagged as oontatamg cnery pdm methods. 

•nie firewall protects these objects from Mcess by applels. The entry point designation allows the methods of 
Ihoe objects to be invokt^ from any context. When that ocaat, a context switch to the jpRE context is 
performed. These methods are the gateways through which applets request privileged JCRE system services. 

TTiere are two categories of JCR£ Entry Point Objects : 

• Temporary JCRE Entry Point ObjecU 

Like all JCRE Enliy Point Objectt, methods of temporary JCRE Entry Point Ot>|ecw can be invoked from 
any applet context Howew. t«fercnees to these dbjceis cannot be stored in class variables, instance 
variables or any componcntt..The JCRE delecU and restricu attempts to store refetenoes to these objects 
as part of the firewall functionality to prevent wauthorizcd («4Be. 

The APDU object and ail JCRE owned exception objecu are examples of temponry JCRE Entry Point 
(Ejects. 

• Permanent JCRE Entry Point Objects 

Ukt all JCRE Entry Point Objects, methods of permanoit JCRE Entty Point Objecu can be invoked from 
any a^let eontext Additionally, reftrences to these ol^'eeu can be stored and freely reused. 

JCRE owned AID instanoes are examples of permanmt JCRE Entry Point Ol^eets. 

The JCRE is responsible for. 

• Determining what privileged services are provided to applets. 

• Defining classes containing Ae entry point methods fcr those services. 

• Creating one or tnore object nutanoes of those classes. 

• DesignaimglhoseinstancesasJCREEntryPointObiorts. 

• Designating JCRE Entry Point OlQecU as temponry or penaaanait 

• Makingrdetencca to those objecu available to applets MBOedfid. 

Note -Only rtte merWr of these objectt are accessible through the firewaU. The fields of these ckjsm are stiU 
protected by the firewall and can only be acceated by the JCRE context « 

OaW the JCRE itself can designate Entry Pdnt Ofcjecti and whether they are temporary or pomanajt JCRE 
iffl, [«nentm are reapoositrfc for implemoBting the mechamm by which JCRE Entry Pomt Okgectt are 
designated and how they became tempotwy or pomanent 

6.2.2 Global Arrays 

Tlw gl<W nature of tome objecu requires that they be accessible from any appla context The 

ordinarily prevent these objectt from being used in a flexible manner. Tlie Java Card VM allows an ol«|ect to be 

destgnatedasg/oM. 

All global amys are temponiy global array objectt. These cbjeds are owned by the JCRE context, but can be 
accessed from any applet context However, references to these objectt cannot be stored tai class variables, 
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ol^ccls u pan offlw firewall fimctiocuatty to prevent wiaidhorind r 



For adM security, only myi con be desgntted u glotel and cnly the ICRE Hself can designate global 

«pptoiiielcctpd.>ieftrt OcX^REaeecpttaDew APDU eonunaod TWi i» to preveni an •pplei't poustiaUy 
ffp»ctiiicqwMiblcfa|w<BcdiiR iccrrtdaitomqrteBce^ 

6^.3 JCRE Privileges 

«ucb M faivocuon. ■ caniext switch oocin fromlfae JCRE eoniett to ihe applet MBtew «mIi«wIx. 

ICRE emm » .pplet conwi Although .ho KTRE could invoke uy .Mfaod ihn^iiMh? folSlU iJl «oJy 
u^Z!^^^"^ P»oce.«, denieet, tad gotSlMnabUlnterf •eaobjeet (tee M.7. 1) mctbodt 
ocpncci In tne J^ppldt dm, 

2]l^.?.2r^^!!!.!inl? wh« the VM begno tunning after . cwd iwet The JCRE 

MOttxi isliw-YiMr ceiiteaand uilwayti ether the cunrendy active contcxl or (he boaom context nved on the 



6.2.4 Shareable Interfaces 

••«rf*«»*«niertoiiK^ 
conlattevwlfdiee«9etttaipl«Baitiiigd>emtoow«Mdly«««lier«^ 

!5* ! f!»?' «»««^«»» «» ^ •«*««>• To My other 

intafice ate aeecaade. AU cte fieldi and mcdiodi ofdte SIO an ptwected by the firewall. 

Shareable IniBftce* provide a »ee« incchaalim fcr Inter^pplct eommirteaifan, a» (MIowr 

I. Toawke an dyed a^UUe to inodMr applet, applet A (int define* a shareable inierftce. SL A shareable 

shareable Intaftee, a. repre«« the aenrtaea thai wte A into aoeewible to oifcer iWtea. 
ffi.t.'^rr'"""." In^Iemcntathe AarcaMe faterite SL C implements die mediodt 

St"»s.SyT£sifsr.?^«^^ 
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3 . Applet A crcAies an object instance O of class C O belongs to applet A, and the firewall allows A to access 
any of the fields and methods of O. 

4. To access applet A*s object O. applet B creates an object reference SiO of type SI 

5. Applet B invokes a special method (JCSyatem.gatApplatShareahlaXntorf aeeObject, described in 
pci«9Bph 6.2*7.2) 10 request a shared tmcrfiu» objea reference fim apidel A. 

6. Applet A receives (he request and the AID of the requester (B) via 

Applet . get ShareableXftterfaceObj act, and determines whether or not it will sfatfe object O with 
applet B. 

7. Ifapplet A ac^ees to share with applet B, A Rsponds to the request with a lefiennce to O. This rei^^ 
cast to type Shareable so that none of the fiddi or methods of O are visible. 

8. Applet B receives the object rcfeence fmm applet A, casts it to type Sh and stores it in oifiect reference 
SIO. Even though SIO actually refers to A*s object O* SIO is of type SL Only the sfasrcahle interfisce 
methods defined in SI are visible to B. The firewall prevents the other fidds and mediods of O from being 
accessed by B. 

9. Appld B can request service from applet A by invoking one of (he shareable interftee methods of StO. 
During the invocation the Java Card VM perfiirms a context switch. The original currently active oontext 
(B) u saved on a stack and the context of the owner (A) of the scnial object (0) becomes the newcunrcntly 
active context A*s implemcntatioo of the shareable Interlf^ method (SI method) executes in A*s context 

10. The S( method can find out the AID of itt dicnt (B) via the JCSyBtem.getPraviousContextAXO 
method This is described in paragraph 6^^^. The method determines whether or not it will perform the 
service for applet B. 

1 1 . Because of the context switdi« the fire%vall alk»ws the SI method to access all the fidds and methods of 
o^ect O and any other ol^ect owned by A. At die same time, the firewall prevents the method tarn 
accessing non-shared otjects owned by B. 

12. The SI method can access the paiametcrs passed by Band can provide a remrnvahie 10 B. 

U. During (he return, the Java Card VM performs a restoring context switch. The orignul cuRenUy active 
context (B) its popped from the stack, and again becomes die cwreat context 

14. Because of the context switch, die firewall agasi dlowi B to access any of its objects and prevents B from 
accessing non-shared ot^ects owned by A. 



6.2.5 Determining the Previous Context 

When-an applet calls JCSyaten.sdtPreviouBContexcAXO. the JCREdiaU letum the instance AID of dxe 
a^det instance acdve at the time of the last oontext switch. 

62.SA The JCRE Context 

The JCRE context does not have an AID. If an applet calls the 90 tPrevtousContaxtniD mctfiod when the 
applet con text waa entered dire^ torn die iCR£ context diis mediod renons nul I . 

If die appld calls ge tPnviouaContextAXO from a mcdiod diat may be accessed ddier from widiin die 
applet Hsdfor when accessed via a shareable interftoe from an extonal applet, it shall check for null renn 
before performing ealla AiD audiendeadon. 
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6.2.6 Shareable Interface Details 

A AanMt imcrftce U amply one that cjucnds (dtfier directly «r mdtatly) the tagging inter&ce 
javBcaxd , Cranemnc . aharaabla. TbU abareahXe inferte tt limilar in eone^ to the Jtenoce tittcrftce 
used Iqf tbe RNQ fiuitity. ID ««ildi caUt to ihe Inicrte mdi^ 

6^.6. 1 The Java Card Sbajneable Interfiace 

Intafeces extending the Shareable taggiog interftcse have th» sptcU^ propevir. calU to the intatux 
inelhodf take place aerais Java Card*i applet firewall boundary via a eootcxt iwittb. 

Hie Shareable tnter&ce serves to identi fy ill dured objects. Any object that needs to be shared through die 
applet firewall shall directly or indirectly Dnpltment diis faiterftoe. Only those methods specified In a Aarcabic 
iitterftoe are available through the firewall 

Implemaitatioo classes can implement any number of shareable intcrftces and can extend other shareable 
implememaiian classea. 

Uke any ^ava plattbrro tnterfrce, a diareaUe iatei«»e simply defines a act ofsaviec methods. A service 
provider dass declares dua it **implenMnts'' die Jdiareabte interftca and piwides fmplemcntadons for each of 
the service medtods of the intcrftoe. A sennoe dicnt das accesses die services by obtaining an object 
rtferenoe, casdng it to die shaitaUe intcrte type if necessary, and invoUog die service mediods of die 
interfile. 

The diaieable inter&oes within the Java Card technology shall have dte following properties: 

• When a mediod in a shareable inters Is invoked, a context switch oecun to die context of die object's 

OtMMr. 

• When die mcdiod exitSt die conteia of die calle is restoredi 

• Exception handling is enhanced k> dial die cincntly active context is correctly restored during die stack 
frame unwinding diat occurs as an excepdon is dirown. 



6.2.7 Obtaining Shareable Interface Objects 

Ifiter^applet commuaicadon is accompliadied when a client applet invokes a shareable inter&ce mdhod of a SIO 
belonging to a server applet In orda for diis to work, dicre must be a way for die dicnt applet to obtain die SIO. 
from die server applet in die flna place. The iCRE provides a mechanism to make diis possible. The Applet 
class and die jcsystam class provide mediods to oablo a dicnt tofcquest service 

6*2.7.1 The Method Applet .9etShareableInterf aceob j ect 

TTiU mediod is implemented by die server applet instance. It sfaaU be called by die JCRE to mediate between a 
cUem appltf diat requests to use an object belonging to anodier applet, and die server applet diat makes its 
objects available for sharing. 

The deftult behavior dial! rcnmi null, whtcb indacata diat an applet does not partidpstc in mtcr«pplet 
communicadoo. 

A server applet dial is imended to be invoked from anodier applet needs to override diis mcdiod. This mediod 
should examine die clientAZO and die parameter. If die elleacAio is not one of the expected AlOs, die 
mediod ihould return null Simibrly, if dieparaatecer U not reoopiized or if it U not allowed for die 
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el i«ntAlD, then the method filso shoutd retora null. Oiherwue, tht applet should refum aa SIO of the 
shareable kntcr&ca type thit the client has requested. 

The server applet need not respond «^ the suae SIO to aU cUents. The server 

shared mterftoes fer diffoent purposes and use clientAXD end parameter to detamine which kind of SIO 
lorenmitothedtcBt. 

6.2.7.2 The Mediod JCSyetem. getJVppletShareableXnterf aceOb ject 

The JCSyaeaa class eontsias the method getAppletShareablatnterf aceObject, which b invoked by a 
client applet to caRumiflicate widi a server applet. 

The JCRE shaU implement this method to behave as fiiUowsi 

1 . The ]CR£ searches its intemsl applet table for one with aerverAXO. If not found, nun is letuned 

2 . The JCRE invokes this ^let*8 gatfih&reablex&tttrf aeeob jaet method, passing the clientAio of 
the caller and the parat&eter, 

3. A context switch occurs to the server applet, and its hnplcmentstiott of getShareahleXncarf aeeObjeet 
proceeds as described in the previous section. The server applet returns a SIO (or mill). 

4. gecAppletSbAreAbleXnterf&eeObj act returns the same StO (or null) to its caller. 

For enhanced security, the implementadon shall make It impossible for the client to tell which of the following 
conditions caused a null value to be renmied* 

• The aanrerAXD was not found. 

• The server applet does not paitidpatetniRter«appletcoramumcatioD. 

• The server applet does not reoogniate the clientAXO or the parameter. 

• The sefver applet won't communicate with this client 

• The server applet wonH communicate with this cHcnt as specified hy the paxanetar. 

6.2.8 Class and Object Access Behavior 

A Static class field is adeeatd when one of the following lava byteoodes is executed: 
getatatie, putatatie 

An object is aoeemi when one of the following Java bytecodes is executed using the object's r ef erence: 

gatfiaXd* putfiaXd* isvOcavirtual . invokeintartaea, atihrow, 
«T>aXead# «T»aatore* arrayXength. Gfaeckcaat* inatwnreof 

<T> reftrs to die various types of array bytecodca» such as baXoad, aaacore* etc. 

This list also includes any spedsJ or optimtxed forms of these byteoodes diat may be implemented fai die Java 
Card VK fifth as gecf ieldjb, agatf ieXd^s^thie, etc. 

Prior to performing die work of the byteeode as specified by the Java VM» die Java Card VM will perfonn an 
aeatss check m the referenced object If access is denied, then a Saeurityfixeeptien is thrown. 

The acoctt checks performed by die Java Card VM depend on die type and owner of dieire&ftnoedobjectt die 
byteeode, and die ewrently active context They are described in die following sections. 
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6.2.8.1 Accessing Static Class Fields 
Bytecotfcc 

9tttat«tlc, putatatic 

■ If the ICRS is the currently active context, (hen acoeu it allowed. 

■ Otherwise, if the byteoode is putatatic and ihc field being stored is a rcferaice type and the reference 
bdng stared is a refirace to a tcnporaty ICRE Eimy Point Objea or 8 

■ Othcrevise» access is allowed. 

6.2.8.2 Accessing Anay Objects 
Byteeodec 

€T»o}o«d, <T»08eore, ayraylcmgtli. thoekeast. ioaeanecof 

■ If the iCRE is dw cuncatf y active context, tfien aocesi is allowed 

■ Otherwise, if the byteoode is aaatore and die component being stared Is a reference type and die 
refiercnee being stofed is a reftrenoe to a temporary JCR£ Entry Point O^ect or a global amy then access 
is denied 

■ Otherwise, if the array is ofwned by die ctnrcady acdve context, dien aeoea is allowed 

■ OdMrwise,ifdte anay is designated globaltttieaaeeess is allowed 

■ Odicrwise,aceess is denied 

6.2.8.3 Accessing Class Instance Object Fields 
Byieoodes: 

gatffiald, putfield 

■ If the iCRE is die currendy active context, then aooeu is allowed 

■ Odierwise, If die bytecode is putf ieid and die field being stored is a reftrcnce type and die reference 
being stored is a refmoe to a temporary JCRE EtoyPoim OtgcGt or a global a^ 

■ Od\erwisekfdie object is owned ^ die omntty acdve comexi,diai access is allowed 

■ Otherwise, access is denied 

6.2.8.4 Accessing Class Instance Object Methods 

Bytecodes: 
iBvokavlrtual 

■ If die object is cmntd by die cunendy active context, dicn access is allowed Contou is switched to die 
otsect owner's context 

■ Odierwise, if die oiyect as designated a iCRE Ehtiy Point Oi^ccC, dien acccu is allowed Context is 
swiidied lo die ot^ owna's ooatcxt (dull be X3tE). 
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■ Othenvise. if iCRE is the currently active cotftcxt. ihen access is allowed Context ii switched to the object 
ownff s omtcxt 

■ (M\crwise, access is denied 

6.2.8.S Accessing Standard Interface Methods 

Bytecodes: 
Invokelncarfaee 

■ If the object is owned by d^e cumntly active context, dun access is allowed. 

■ CKhcrwise, if die iCRE is die cunendy aedve coatcxt. dien access U allowed. Context is s%vitched to dtc 
ohjoct owner's context 

■ Odierwise, access if denied. 

6.2*8«6 Accessing Shareable Interface Methods 
Byteoodes: 
iDvokaintarCace 

■ If the Object is owned by the currendy active context, dien access is allowed. 

■ CXherwise, if die otijcct's class implements a sbAreable interface, and if die interface being invoked 
extends die Shareable tnter&ce, dien access is allowed. Context is switched to die Object owner's 
context 

■ Odkerwise, if die ICF£ is die currently active context, tfien access is allowed. Context is switched to die 
otiject owner's context 

■ Odierwise, access is dotted. 
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6.2.8.7 Throwing Exception Objects 
B>tecodes: 

athroif 

■ If the objea U Qwned by ihe currcaUy aaive context then mess is allowed 

■ OAew4se,lfiheoJjectlsdesignated«X»EEmnfPototOl^ 

a Otherwise, if the iCRE a ihe cuircndy active oontnt. then access is aUowoL 

■ Otherwise, access is denied. 

6.2.8.8 Accessing Class Instance Objects 
Bytecodes: 

ehaekcast* instaneeef 

0 If die olyea is owned by the cuiently active comait» dien access is allowed. 

■ 0(bemfse»irJCRE is die currenUy active caiteat,tfien access is allowed. 

■ Otherwise, If^t object is desiptated a JCRE Entry PoinI Object, dsen access is allowed. 

■ Otherwise. ifdielClUE is die oinouly active context, then access is allowed. 

■ Odterwise^ access Is deided. 



6.2.8.9 Accessing Standard Interfaces 

Bytecodes: 

ehttckcaat. instanceoC 

■ irdiecbjeoisownedbydieciBfendyaciiv«cQntcRt,thcQaGce»Ssallo«^ 

■ Od)erwise,ifdteiCR£ is die curreaUyacdvacoatotidienaceett is allowed 
m Odierwise, access is dcaied. 

, 6.2.8. 10 Accessing Shazeable bterfiices 

Bytecodes: 

checkcaBt. invtaaeeof 

■ If die object is owned by die cumendy active context, dtea access is allowed. 

OUienwise. if die olQeet's dass implements a Shareable inter&ce, and if die olsject is bong cast into 
(checkoA) or is an insttnce of (instanceoO m interf see dial extends die Sha ceabl « taterftcc* dicn access 
Is tUowed. 

■ Odierwise^lfdieiCRE is die cunently active context, dioi access wallowed. 

■ Odienviscacceu IS denied. 
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6.3 Transient Objects and Applet contexts 

Transient objem of CI£AR_on_R£SST type behave tike pentisient ot^eeca in that diey eaa be acceaaed only 
when the currently active applet context U the aame aa the owner of the olgect (tfie cuncnUy active applet 
context at the tfme when the object was created). 

Traniient objects of CLEAR_ON_0£S£ti&CT type can only be created or accessed when (he currently active 
af^lei context is the cuttntly selected applet context If any of the taakeTranslent &ctary methods is 
called to create a ClXAR_OH_OB£EL£Ct type transient object when the currently active applet context ia not 
the currently selected applet context, the mtiihod shall throw a Syst emBxcep cion with reason code of 
ILLEOAL^TRANS I£KT. I fan attempt is made to access a transient object of CLSARjOH_D£SBL£CT type 
when the currently active applet context is not the currently selected applet context, the iCRE shall dirow a 
SeoirltyBxception. ^ 

Applets dial are part of the same package share the same group oontexL Every applet lastaaee fton a package 
shares all its object instances with all other instances fiom the same package. CHiis includes traasieat objects of 
both CLEAR_ON_R£SBT typt and CLEAR^Otf^DESBLECT type Owned by these applet insMaees.) 

The inasient objects of CLSAA^OKT^DESELBCT type owiied 1^ any applet instaaoe within die same package 
shall be aoeeaaible when any oflhe applet Instances in this package is the cuirently selected applet 
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7. Transactions and Atomicity 



A«™u«tfo« u . logics rw of upduc. of pariaeni dau. For cMnpk; dansfamgKBe ainoum ofmrny 

*e dw fidd. « updMd. « none «. The JCRE provide robust i»pp« ibr otomie wmmtioMr." *.t c«d 
dtti » r<.lor«l to it. ongiMi pre-trmswion ««. if the nn^cm do^oi eoinplctei^mSKu 

ibitmigtae»BedM»eoii^«ioBAouM«lliie|»ofateBmetw •™»p™gn»i 



7.1 Atomicity 

Atnnicity defiim how the ewd hcndJei the canttms of pcrsittait noran after s itop failure^ or ilital eumtinn 
applc.d«vdopori»IlbeaM*lorcly«whaiihefleMorai»y«Bip<aailcwaiD.^ 

«y 'VA'tt toa atagtepBahKmrtjeat ordatt fieW «iU be atomic In 
aMAion, me Java Card plaKom ^rovidea single oomponcai evd atooidty for pcniftai ann. Thai ii. ir die 

*iat,hallbapre»cwtdac»«aCADacaai«a.ltatdaudenKmwaibaiSwd«aJii^^ 

Some methods also guarantee atomidty for block updates of multiple data elonents. For example the atomidly 

fcflb»piin)o.clidoeaiwi«d»««Ma«i«.«o«mltb«lfaevai«hmSSJ^ 



7.2 Transactions 

An applrt inight need to aiomicaUy qidaie aewal diffatni fields eranay eomponaiis in several different 
o^oj^jUh^Ukaptoeo^^ 

•n>e Java Cird plstfom> upports a nansadiooal model in which an applet can deainate ihebeginainof an 
aio«.c.etofupd.te.wi,haedlt«,h.JCSyat«.b..lnT»««.etiLo«ho4Sr 
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p oimiico nditiflntlly updated. The field or anay companciit appem to be UDdated-teuliiia A. 
component back yield, h. i«e« omditional val«e4Slte,iE„« ^ 

wn«tlfpowi,|oatorlf»oiiieother«yBanWlureoecOTpri« «»«»pcnwBW 
JCSyat «m . cooml tTraiiMettOB, all eondldeMay updated field* or tmv eomDonaiti »< t„««^ a-, 

p,Ogr«B««.e.lly wwlo candhkmrfivdaiealy «alltagitty«.„.rtK«iwu».etia^ 



7.3 Transaction Duration 

A, inaiau^ always «imU when die JCRE ngmt programmatic oonirol upon return from the applet's aeleet. 
^.elact. precox, or ln,tM med«U.. Xhit ii m.ewh«h«a««»«rton «,d. nonnaUy. 5* J^Ste^ 
Sl?J?T^'i^!22i"i*^ or with an abottioo of the nsmaim (eHher pro^ammatieally bvAe • 
by debult by di* JCRE). For more deiaila on nnaaGiian abonion, wto^^^^^l * 

acalltoeaagaitTraiiaaetlenaraaateiridnofihalnnaaeifam. «««.,»M«iioei 



7.4 Nested Transactions 

The model eumndy assuiaet did nested (raatactieiu arc not possible. Th«»e can be only one naasaetian in 
progress at a nme. If JCfiy.ten..be9lnTnm»»etion is called while a trmsaciim is alioufaf inlMogress. dien 
a TranaactlenExeeptlen is dnown. 

TheJOyatem . trutaaceioaDapth mcttiod is provided to allmr you to deteanine if a OwsaetiaQ is in 



7.5 Tear or Reset Transaction Failure 

*eB die JCRE shall restore to their previous vahio all fields and amy camponents eondidanally upd^^^ 
dieprewouscalltoJCSy8t«m.bo9iBt»«uiactloa .r-t~-~- 

This tctim is poftnned automatieally by the JCRE when it reinitialius d,e card after recovering fiom dw 
Sd!w^ aSI.* dtteriBines which of diose objects (If any) wen oondidcoally updated, 



^'r^jribTth^^CRE"*'""' "'"'^ "•"f^ diat MteJ due to power fcat or cart tasat 
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7.6 Aborting a Transaction 

Trauaotott can be aborted dtiicr by an appid or 1^ tfie JCRE. 



7.6.1 Programmatic Abortion 

If an applet cnoountere an mtonal problem or decides to cancel (he (ntnaction, tt can ptogrammatically undo 
eonditionai updates by calling jcsyoCttn.aijortTrattsttction. If Ibis method is called, all conditionally 
^dated fields and array components since die previous call to acsystem.faegiaTraiiaaccion are restored to 
their previous valuea» and the JCSyotem. tronaact ionoepth value Is fcsd to 0. 

7.6.2 Abortion by the JCRE 

Ifu^piet returns fiom the select* doacI«ct , process , or install mediods with a oansacdoo in 
progress the JC^autonatieally aborts die transaction. Ifaremro from any of select, deselect, process 
or install methods occurs wiOi a oansaction in progress, the JCRE acts as if an excepttcn was thiown. 

7.6.3 Cleanup Responsibilities of the JCRE 

(Mject instances created during die ttransaction thai U being aborted can be deleted only i f aU references to dkcse 
o«ects can be located and converted falo null . Tlw JOm shall ensure fltti refcrencBs 
during die aboited transaction are equivalent to a null reference. 



. in Transient Objects 

Only^Q>dattttopa^ ypaatea to transient oyecia are never undone, 

regardless of wbedicr or not diey were *insida a nannction.** 



7.8 Commit Capacity 

Sface platform resourees are limited, Use number of byta of conditionally updated data that can be wwffnulattd 
*™£ a Msacdoo is tinted. The Java Card technology provides mediods to determine how much commit 
c^jy » BJ^laUe on die implcmmtatian. nie commit capacity repitsents an uppa bound cn dw number of 
conditicoal byie updates available. The acftnl numba of conditional byte updates available may be tower due 
to management overhead. . ' 

An excepdoa is dtfown If die comndt capadty is exceeded during a transact 
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8. API Topics 



The topics u Ais dttptcr comptemcm the rcquircmems ipedfied in the Jww Card 2» I API Dr^ 2 
SptG^cation. The first topic it the lava Card I/O fimciioaality. which is implemented catircty la die APOU dass. 
The teoond topic it the API cuppcrting Java Card security and cryptography. The jcsyetem class encapsulates 
the API vcnton level. 

Transactions within the API 

Unlos specifically called out tn dieJdvii Card 2 J API specification, the tmptecnentadan of die API classes 
shaU not inhiste or odicrwise alter die state of a innsaction If one is in progiess. 

Resource Use within the API 

Unless spedfically called out in die^tfva Cant 2. 1 API Spetificeaiont die fmplementaticn ^all support die 
hivocation of API instance mediods« even when die owner of the object tnfisnce is opt die currently selected 
applet In odia words, unless spedfto&tly called out, die implementation shall not use resources such as 
nniient otgccts of C1EAIL0NJ>ESEL£CT type. 

Exceptions thrown t>y API dasses 

All exception obfecu dirown by die API implementation shall be tempoiwy JCRE Envy Point Otdects. 
Temporary JCRE Entry Point OtQccts cannot be stored in class variables. Instaaee variables or array 
components. (See 6.11) 



8.1 The APDU Class 

The APDU dass encapsulates access to die ISO 78 16-4 based I/O across die card serial line. The APDU Oass is 
designed to be independal ^die undcriying I/O transport pfotocd. 

The JCRE may support T«0 or T*t transport protocols or bodt 



8.1.1 T=0 specifics for outgoing data transfers 

For compatibility widi legacy CAD/tcnninsls diat do not support block chained mechanisms die APDU Class 
allows mode selection via die oetOutgoingKoChaining mediod. 
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8.1. LI CoDstreiaedtransfeiswtdinoch 

When theno cfaainoig mode of output transfer b requested by the applet by catling the 
setOutgoingKoChaining method, the following protooo! sequence shall be fotiowed. 



Note - when the no chaining mode is used, calls to ^ wait Ext ena Ion method shall throw an 
AgPOException with reason coda IIXBBJU»_08R 



Notation 

Le «• GAD expected length. 

Lr " Applet rc^wnse lengdi s«l via setOutgoingLength method 

<N^ * the protoeol byte equal to die Ineoming header INS byte, which nuficaies that all data bytes 
wilt be traasftned neat 

<-INS> • the protocol byte that is the convlemcat of die neomiag header IN$ byte; %vhich indicates 
about I data byte being transferred neat 

<SWI .SW2> - the response status bytes as in ISOTS 16-4. 
IS0 781&4CASE2 

1. The card sends Lr bytes of output data using the sauuM TH) <INS> or ^^INS^ procedure 
byte mechanisRt 

2. The card sends I ,SW2> completion status co completion of the Applet . procoo a 
me i noii. 



1 . The caid sends <0x614/> completion stams byta 

2. TlieCAD sends GET RESPONSE etmunaad with U« Ix. 

3. The card sends Ubytaofotttpttdau wing the 8i8ndardTKI<INS> or <»INS> procedure 
Isj^e mechamsnv 

4. The card sends <SW1 ,SW2> completion staais «n compledon of the Applet . proceaa 
mcdiod* 

U>Le 

1 . The card sends Le bytes of output dau using the ststtdard T*< <INS> or <*INS> 
prooedure lyyte roeehanism. 

2. The card sends <0x6 1 ,(Lr*Le>> completion status bytes 

3. The CAD sends GET RSisPONSE oommand with new Le 

4. The card sends (new) Le bytes of output data using die standard T"0 <INS> or <o-Dt|S> 
prooedure Ivyte mechanism* 
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5. Repeat itept 2-4 as necessary to send the fcnanung oufput dau bytei (U) as required 

6. The card sends <SWKSW2> compleiiott ttsius go completion of the Applet . proeesa 
method. 



ISO 7816^ CASE 4 

tn Case 4« Le b determmed after the following initial exchange: 

1. The card sends <0x6KLr status bytes> 

2. Hie CAD sends GET RESPONSE command with Le <• tr. 

Ihe rest of the protocol secpicnce is identical to CASE 2 described above. 

If the applet aborts early and sends less than U bytes, xeros may be sent ioAead to ait out the lengdi of the 
trttDsfer expected by the CAD. 

S.t.i.2 Regular Output transfers 

When the no chaining mode of output oransfcr is not requested by die applet (dsat ia, the setOutgoing 
method is used), the following protocol sequence shall be followed: 

Any tSO-7ftl6«3M com^iant T«<0 protocol transfer sequence may be used. 



Note - The «rai t£xtenalon method may be invoked by the applet between successive calls to eendSyteo 
or send&ytealiong methods. The waltBxtetkeion method AaQ request an additional worh waiting time 
(ISO 7816-3) uang the 0x60 procedure byte. 

8.1.1.3 Additional T^> requiremeiits 

At any time, when the T«0 output ttansfer protocol Is in use» and the APDU class is awahing a GET 
RESPONSE command from the CAD in reaction to a response status of <0x61 . xx> from die card» if die CAD 
sendi in a dtfforent command, the aendBytiefl or die aeAdByteationg methods shali throw an 
APDUBxeeption wifo reason code NO.TO.OBTRBSPOKSB. 

Calls to aend&ytea or fiendByteaX^g mediodi from this point on ih&ll result in an APDOBxceptlon with 
reason code ItJUEGAL USE. If an ISOSxcopt ion is dirown by the applet after ±t NO_T0_GETK£SPOKSB 
exception has been thrown, the JCRE shall discard the response ststits in Hs reason code* the iCftE shall restart 
APDU processing widi fht newly received command and resume APDU dispatching. 



8.1.2 T-1 specifics for outgoing data transfers 
8.1^.1 Constrained transfeis with no chaining 

When the no chaining mode of output transfier is requested by the applet by calling die 
aetOutgoingNoChaining medtod. die following protocol sequence shall be followed: 

Natation 

Le - CAD expected length. 

tr • An)let response lengdi set via a otOutgoiiigLengch method. 
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tht Kquenoe shall not use Uock duuning. Specifically, ihe M*bU (more data bit) dull not be 

Note - Whco die no chatoing mode ii used, calla to the wax tExtenaion toelfaod throwon '• — 

APDOExceptloo with tcawtt code ItUSOhLJOSSL 



8.1.2J Regular Output transfers 

When the no chaining mode of outpu 
used, the following protocol cequcnc 

Any ISO>78tM/4 compliant T*l protocol tranifer sequence may be used 



When die no chaining mode of output transfer b not ieq[uested by the applet ie the netOutgoina method ia 
used, the following protocol sequence shall be followed: ^ 



Note - Hie waiCExtennion mettiod may be Invoked by the applet between 8^ccc8sive calls to eeaOBr^ 
or oendBytasLong meteds. The waitBxtanaion method shall icsd an S^lodc eemmand with WTX 
of INP tmit^ which is equivalent to a request of I additional work wnitmg time in T-0 mode. (See ISO 



8.2 The security and crypto packages 

Javaeayd. security .MaaaageDigest 
j avaeaxd . aeeur ity , 8igitatuk« 
javaeard* eeeurity « Rai^taData 
j avacardbc . eryp to . Cipher. 

An invleMtation of Ae JCRE inay implement Oct more of die el^^ 

algondtm dut ii ooi imploDDcated is icquested thia metfhod shall ihiow a CtyptoBxcept ion widi reason 
code KO^SUCU^JOiOORXTHIi 

Ij^taart^ qf the above classes sbaU extend die conoponding base clasi and implement aU die abstract 
mediods. AU data sUocation associated with the implementatioo instance diall be performed at the time of 
mjtooeconstrwaonw 

SimilaHy, die buildKey mediod of die javacaxd.aeottrity . koysuilder class temms an 
raplemeotttiM insOHwe of die te^^ 

key typg tf>tf ts not implereaited u icqueated, die method ahaU throw a erypt^iRirciyt trf^i. >y,ff^n rmlf 
N0^8tlOI_ALQ0IUtl&i 
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ImplementAQons of key typo shaU tmplemeot the associated intcrfece. AU data allocation assodated with die 
key implementation iostance shall be performed at (he time of instance omstnietieii to ensm dui any lack of 
required resources can be Bagged early during the installation of Ihca^^ ^ 



8 J JCSystem Class 

In Java Card Z I . the ge tvereion method [ihali return (short) 0x020 1 . 
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9. Virtual Machine Topics 



The tq>ict tn ihU chapter detail viituil machine ipcctficf. 



9.1 Resource Failures 

A lack ofrtsounxs condition (aich as heap which U recovtrible shall result in a SyseenSxeoption 
with reason code vo^rssourcs. The &ctoiy mettiods in jcsyacem used to create transient anaya.tlvow a 
Systemsxceptloo with reason code tiO.tRARSIClT.SPACB to indicate lack of oiniient space. 

All other (nooHccovenble) virtual madiine eirors such as stadc overflow shall resub in a virtual machine enw. 
These conditions shall cause the viitual machine to hah. When audi a ooniecowable virtual machine cnor 
occurs* an implementetion can ^ionally itquiio the card to he muted or bM 
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10. Applet Installer 



Applet instaltation on smart cards using Java Card technology is a complex topic. The Java Card API 2 I U 
intended to give JCRE implemeotcn as much freedom as possible in their implementations. However some 
basic conunon specifications are fequired in order to allow Java Card applets to be iaatalled without loiowinR 
the implementation detaiis of a particular iamller. 

Iliis specification defines the ooncqst of an Instalfax and specifies minimal mnaUatioA requirements tn enler to 
achieve interoperability across a wide range of possible lostattcr implemmtalions. 

TTie Applet InstaUcr is an optional part of the JOIE 2. 1 Specification, nat is» an implementation of the JCR£ 
does not necessarily need to include a post-tssusnee Initallcr. However, if implemented, the tnstaUcr is requied 
to support the behavior specified in section 9.1. 



10.1 The Installer 

The mechanisms necessary io insull an applet on smart cardi using Java Caid technology are embodied in an 
on-card component called the Instolhr, 

To the CAD the ImAallcr appears to be an applet. It has an AID, and tt bccomea the cunreody selected applet 
when this AID is successful ly prooeued by a SELECT command. Once selected, the InateUcr behaves In much 
the same way as any other applet 

• It receives all APDUs just like any other selected applet. 

• lu design specification prescribes the various kbds and fismsti of APDUs that it expects to receive along 
widi die semantics of those commands under various preoonditions. 

• It processes and responds to all APDUs that it receives. Incorrect APDUs are responded to with an enor 
condition of some kind. 

• When another applet is selected (or when the card is reset or when power is removed from the card), the 
I Astallff becomes deselected and nsnatns suspended loitil the next time that it is SELECTed. 

1 0, 1 . 1 Installer Implementation 

The Installer need not be implemented as an applet on the CKd. The rtquitwnem is only that the installer 
fimcrienaiicy be SELECTable. Tlie corolUry to this requiiement is that Installer component not be able to 
be invoked when a non^lnstaller applet is selected nor when no applet is ttli rTH 
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Obvlouily. a ICRE iinploRcnttrcoiild choose to implemcat the butallcr asao ap|Act irn» Aa ths Innaller 
might be ooded to extend die Applec class and iti|Mnd to tovocadons of die aeUcc, proeeaa, and 
deaolect methods. 

But A JC3UB implementer could abo inplemoit die Installer in oUicr ways, as long as h provides the 
SELECTaUe bdiavior to the outside world In diU case, die iCK£ tmplemcnta has die freedom to provide 
some odser mechanism by iwhidi APDUs are deltvofed to the bistaila oode module. 



10.1.2 Installer AE) 

Because the Instelter is SELECTaUe, it shall have an AID. JCRE implcmentors are free to choose dieir own 
AID by whidi dinr Installer is selected. Multiple instaUeis may be Implenemed. 



10.1.3 Installer APDUs 

Ibe Java Card API 2 . 1 does not speeiiy any APDUs for die Installa, JCRE implemeaters are cmirely free to 
choose their own APDU oommsnds to direct their Instailcar m its work. 

The model is diat die InstaUcr on die card is driven by an installadon pro^nmnmningon the CAD. In order for 
installadon to succeed, diis CAD iastaltadon program shall be able to: 

• Recognise die card. 

• SELECT die Installer 00 die caid. 

• Drive die instatlstion process by sending die appropriase APDUs to die card Installer. Theae APDUs will 
contain: 

>, Audiendcationinfbrmstion, to ensure diat die installation is audionzed. 

> The applet code to be loaded into die card's merooiy. 

> Linkage infiBcmadon to Ibik die applet code widi code already on die card. 

> Instance Insdalizatioo parameter data to be senl to die applet's iuBtnll medio! 



The Java Card API 2.1 does not spcdiy die detalU of die CAD insaliation pr^ram nor die APDUs passed 
between Hand die Installer. 



1 0. L4 bistaller Behavior 

JCRE fai^cmcnters dull also delme other bebaviora of dieir bistolla, inchidiag: 

• Whether or not installadon can be aborted and how this is done: 

• What happens ifanexoepdon, reset, or powerful occurs diving installation. 

• What hsppensifaaodier applet Is selected before die Installer is finiAcdwidi its work. 

llie JCRE shall guHnalBe that an applet will M be deemed suoGcsslblly bstolled if: 

• die applet's iaatall mediod dirows an exeq^on before sucoeaslid retwn from die Applet , sogiater 
mediod. (Refer to parapaph 9^0 
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1 0. 1 .5 Installer Privileges 

Although an Installer may be tmplcmented as an applet, an iMtatle will typically require access to ftatures (hat 
aie not available to **other applets. For eauunple* depending on the JCRE fanplemeater'i implaneniation, the 
Installer will need to: 

• Read and uvita directly to memory, bypassing the object system and^orstandaidsecurit^^ 

• Access objects owned by other applets or by the JCRE. 

• Invoke non<niry point medioda of die JCSk 

• Be able to invoke the Install method of a newly installed applet 

Again, it is up to each iCR£ bnplementer to deteraine the Installer implementation and supply such features in 
their JCR£ implementations as necessary to support their Instal ter. iCR£ implementers are also icsponsible for 
the security of such feanirea, so that they are not a vailaUe to nonnal applets. 



10.2 The Newly Installed Applet 

There ii a single inter&te betw^een the Installer and the applet that is bdng installed. After the Installer has 
correctly prepared the applet for execution (performed steps such as loading and Imking), the Installer shall 
invoke the applet's install method This method is defined in the Applet, class. 

The precise mechanism by which an applet's inatall method is invoked from the butaller Is a JCRE 
implcmcmcrwlefmed implementation detail, However, (hae shall be a context switch so that any context* 
related operations performed by the install method (such as creating new objecu) arc done to the oonteat of 
the new applet and not bi the context of the Installer. The lasttllcr shall also enme that amy objecta created 
during applet class initialization (<clinii>) methods are also owned by the cantexS of the new applet 

The bistalUticn of an applet is deemed oomplete If all steps are completed without fiiUure or an exception being 
thrown, up to and inchidlng successful rcun from esteeuting the Applet . register method. At chat point, the 
Installed applet wiU be selectable. 

The maximum size of die parameter data is 32 bytes. And for secunty reasons, thebArray parameter Is teraed 
after die returo (jtist as die APDU buffer is xcroed on return from an appla's proceaa method.) 



1 0.2. 1 Installation Parameters 

Other than the maximum size of 32 bytes, Ute lava Card API 2.1 does not specify anythfaig about the contents 
of the installation panmcter byte amy segment This is fully defined by the applet designer and can be in any 
format dented. In addition, these installation parameters are inteaded to be opaque to the Installer. 

JCRE implementers duaild design their Installers so diat it is possible for an InstallatiaB program ruming in a 
CAO to specify an arbittary byte array to be delivered Co the lattslltf. Tlie Installer simply forwards dus byte 
array to die target applet's inatAil method to the bArray parameter. A typieal Implementaiion might define a 
iCRE implemAter<fffoprietaiy APDU command U\at has die semantics **eall die applet's instaU method 
passmg the coatmts of the accompanying byte array." 
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n. API Constants 



Some of the API classes don't have values specified for their oonitamt in the Jems CardAPt 2 J H^tmet. If 
eonsiant vahies »t not specified consisicntly by implemeatm of dils KB£ 1 1 Spediicatlon, industry-wide 
intBropcrahUity is tnipouiU& Ihis chapter pravides the required vahies Hor oonitantt that are not specified in 
the Jwfa Card API 2.1 iUftnae^. 



aass iavacard.framework^APOU 

public static flnaX byte PMOTOCOL^TO - Oi 

public etAtie tiaal byte PROTOOOLuTi * if 

Class Javecard.f^6fwor1cAPDUExoepdon 

public otatic final ehort XtLBCUO uOSB • li 

public atatic final abort BOTFBR BODHDS • 2$ 

public atatic final abort BAO.LSSOTH • 

public atatie final abort zq^BRROR • 4i 

public atatie final abort l»jro.OBnt8SMli8B « OxMii 

tnterfeoo {avacanlJtamMOtk.1807816 

public final atatie abort SH SO SIU»R • <ahort>0x9000i 

public final acatic abort sh^bytes^rbhaiizzso^QO • 0x6i00f 

public final atatic abort 5N UROSO^LBHOTH • ox«700i 

public atatic final abort 6N SB0CnUTY.8TKniS IR3TjSMrXSnBD • OlieeSSf 

public final atatic abort SM.ms^nimXO - 0x«»B3i 

public final atatic abort SMJDAtA^XSVALXD • 0x6964i 

public final ecatJLc abort SN^OOEIDITiass.lOT SATZSFXBD « Ox698Si 

public final atatic abort SH OOHNABD SOT RLbOMBD • 0x6986 1 

public final atatie abort mTmimJstXCtjnacum • M9$9t 

public final static ahort BdljnomjiKSk • OxCASOi 

public final atatie abort WHjnJSCjmjBOPVOKTBD • OxaASli 

public final atatie abort aw.FZZiB mjecmo • Oxaiwaa; 

public final atatie abort SU RBC^ HOT raOKD - 0x41183 1 

public final static abort SNf^ZMOORRBCT.PlPa • 0X6*08; 

public f izial atatie abort Sif imoi».PlP3 • 0x6800 1 

public final atatic abort 8W,O0RRBCT,HMglW^0O • oxeooor 

public final atatie abort 81t W6 VOX 6UV9QRT80 • 0x6000 1 

public final atatic abort SllIcUl*B0T~8U99QRT8D • 0x6800; 

public final static abort SV.ISQMIOt • 0x6F00i 

public atacie final ahort SH^FZLS^FOU* • 0x6A84/ 

public final atatie byte OFFSgT^mi • Oi 

public final atatic byte OFFSBT ZSB • li 

publie final atatic byte OPFSET^Pl • ai 

public final atatic byte 0FV88T pa • 3; 
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public final ctatic brt« OPPfiBT.lX • 4/ 

public fiiul static byte OPPSET.CDATA« S/ 

public final otatic byta CLA_X$07ai€ • 0x00/ 

public final static b/te XKS^SRLeCT - (byte) 0xA4i 

public final static byte XHS_SXTBIuaa.Jumi8fTSO^TK • (byte) 0x63; 

Oass |av8C8rd.fram6work.JCSystem 

public static final byte HOT A TRWJSIEMT OBJECT • Oi 
public static final byte CLBAR.OM.asSfiT • 1; 
public static final byte Ct^kkJMJOBUMCt - 3: 

Qass Javaeard.framawork.PtN&(coptlon 

public static final abort XtLSfSlL.VALDS • 1/ 

aass I8vacard.fram6f#ort(.8y8lam&coeptfon 
public static final sbert XLLSGUO* vautb • i; 
public static final short N0_TRMBXBMT^SPAC8 - 2i 
public static final short XLLBGia TaAKSlSMT • 3/ 
public static final short tLUBOkUjao • 4; 
public static final short HO^RSSOURCB « 5: 

Qass laivaeard.8ecurlty.CiyptoExoeptton 

public static final short XLLSOAL VMUJB • It 
public static final short GHXHXTtALXZBO KEY • 2; 
public static final short ho_STX».AUX)RX1KM • ai 
public static final short xnvauo.XiiXT • 4 ; 
public static final short XXXSGMU^OSB * Si 

Ctaas Javacafd.8eeurtty.Keyedtder 

public static final byte TYPB_0£S_TRAN8XfiMT.RaSBT - li 
public static final byte TyPE.SEfi_TRAK8X&»T,tSSSBUtCr • 2i 
public Static final byte TYPB^DSS"- 3; 
public static final byte TtPtJ^mLte - At 
public static final byte TYPB^fiSA.PIUVKrB • %f 
public static final byte TYPE VU&AjXXJPKPrm « €j 
public static final byte TtPB^DSA^POBLXC • 7; 
public static final byte TYPB^OSA^PRlvm • 6/ 
public static final short tSNOTKJDBS • €At 
public static final short LSiltmi_D£S3_aiCnr • 138/ 
public static final short L8»XTKJ3BS3^3KEnr • 193 1 
public static final short LSIOTH^RSA^SU • 513; 
' public static final short LBxmiijLSkj7€B • 766 1 
public static final short tSHant.RSA.l034 • I034i 
public static final short tJBiiaTH.RfiA.304 8 • 3048/ 
public static final short LBKOTH.DSA.SIS • 513; 
public static final short LBXtOXa OSA.76e •7661 
public static final short LSKCrTU.DBIl.l02 4 « 1034 1 

aass i0vacard^ecurity.M68sageD}Qe9t 

public static final byte ALO.SKA • li 
public static final byte ALO.fOS -31 
public static final byte AliO.RlPEKDlCO « 3i 

Qaas javacard.90curttyi%andomData 

public static final byte AliO.PfiSDDO.RMOXM • 1; 
public static final byte ALO.fiBCURB.RAUDON -3; 

aass )avecQRl.securtty.Sign8ture 
public static final byte AU>.DB5.km:4.hqpm3 • if 
public static final byte AIO DBS MACB.SOPAD • 2t 
public static final byte AUI.0BS.KAC4.X5O9797.H1 • 3; 

2 CopyrtsMOOeoembarl4.19d8SunMicfosy8tsm8,lAe. 
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public ctAtic final byte Aba.DBS_MACe_XS09797 Ni - 4; 

public AtAtic final byte AU}.P£SJKAC42sS09797*K2 • 5| 

public otacie final byte ALa'DB8'MMCa*'zS09797*}Q • d 

public static final byte iaAJ3BSJOyC4*PKCS5 •"'7| 

public static final byte AtOjDSSJCACS^nccsS • 8i 

public static final byte MJaj^fTsWi ZS09796 • 9| 

public static final byte ALO nSA'sWk^VKCSl • iQt 

public static final byte AL0.RaAj<lO5 PXCSl • lif 

public static final byte Ma RSAJRXPBMD160 XS0979( • 12) 

public static final byte ALO RSA RXPEMD160*PXC81 • 19| 

public static final byte ALa*iDSA*SHA » Mi** 

public Static final byte HOoi 8XQi • li 

public static final byte NQOS.VCiary « 3/ 

Claas iavacanlxxiypto.Ci|»her 

public static final byte ALO OSS G8C tiOPAD • li 
public static final byte ALO*OB6JCBC*ZS09797 Kl • di 
public static final byte ALa'DES.CBC*XS09797''K2 • 3| 
public static final byte ALoHdss CbOkCSS •~4r 
public static final byte ALa'*DBs''scB'MOPAO • s / 
public static final byte ALa''DSS''8ca3xso9797 Hi • <i 
public static final byte AI/2 DBS 8CB XS09797''n3 • 7| 
public static final byte ALO^DSSIbcb^PMCSS -"at 
public static final byte AM^^Zx^Ol^'B* - 9t 
public static final byte AUI RSA^'pXCSl • 10; 
public static final ^e MOoi moim • 1; 
public static final byte K0DB*8MCRYPT • 3i 
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Glossary 



AID Is an acronym far Application IDeatifier as defined in ISO 7816-3. 

APDU is an aocmym for Application Protocol Data Unh as defined in ISO 78 16-4. 

API is an aoronym fw Application Prognunming Inta&oe. The API defines calling convenaons by ^tch an 
application program aoecates (he operatu^ s>neffl and other flervioei 

Applet within the context of this document means a Java Card Applet, which is the basic tndt of selection 
context, functionaHty, and security in iava Caid technology. * 

Applet developer refers to a person creating a Java Card applet using the Java Card technology spedficatioos. 

Applet fircwaU b the mechanism in the Java Caid technology by which the VM prevents an applet from 
making unauthorized accesses to objectt owned by other applet contexts or tfte JCRE context, and reports or 
otherwise addresses the violatiotL 

Atomic operation is an opemiion that either oompteies in its entirety (if the opaatica succeedt) or no pan of 
the operation completes at all ftf theopersticn &iU). 

Atoodcity refers to whether a particular opei^on is atomic or not and is necessary for proper data recovery in 
cases in which power is lost or the card is unexpectedly removed from the CAD. 

ATR is an acronym fiv Aiuwer to lUaet An ATR ia a string of bytes sent by the iava 
condidon. 

CAD is an amoym for Card AocepUAce Device. The CAD is the dcvioe in which the eani is tnsoted 
Cast is the explicit cooversioD from one data type to another. 

UCK is dte test suite to verify the compliance of the implementitiQo of due Java Card Tedmology 
speeificadoni tlie ciCK uaca the JavaTest tool to nst die tett suite. 

Oais ia the piototype for an ol^ ect in an object-oriatted language A ebaa may 

ot^ectsthatdiarctoammon structure and behavior. The structure ofachwiadetctinioed by the daasvaria^^ 
that represent die state of an otdectof that class and die bdiavior is giwn by a set of mediods associated witfi 
iheclfttt. 

Classes are related in a class hierarchy. One class may be a spcdaiization (a subclass) of another (its 
superclass), it may have reftrenoe to other classes, and it may use otha classes in a cUait<4er%«r fclattonship. 

Ctoatcflft (See Applet executioo context) 

Cnrently active context The iCRE keeps track of the cumnUy active Java Card applet context. When a 
virtual medtod is invoked on an dfaject* and a context switch is required and pemined, die currently active 

Copyright OOeoembar 14. 1998 Sun Miaosystma. Ina 1 



suBsrrruTE sheet (rule 2b) 



wo 00/45262 



47/16 



PCTAJSOO/01234 



Java ^ Card ^ Ruatine Eovinmnicnt (iCRE) 2. 1 Spedfteation 

context is changed to cencspoodto tfaeapptct coniext that owns the tibieet When that method retuns, the 
previous context ts restoitd. Invocationa of static methods havn ooefliBCt on the cwmdy active context The 
cumndy active coaiBxt lad shaihig swus of ao olgeel t0g^ 

Camstly tcleeted a|^t The ICRE keeps track of the currently selected Java Card applet Upon receiving a 
SELECT command with this applet*B AID, die iCRE makes this applet die cwrcndy selected applet Ihe JCR£ 
sends all APOU commands to the cuncndyaelccled applet 

ECPROM is an aaooym for Beoricalty Erasable, PropimmaUc Read Only Memory. 

FIrewaU (see Applet Firewall). 

Framework is die set of classes that inclement the API. Ihis tndodes core and extension packages. 
RcspottsiWIidcs include dispatching of APDUa, a^et sdectkm, managing atomicity* and installing apptcta. 

Gartagt eoOtctetodw process by which dyoamicatly alloeamd stflrage b automadcally rectafaned during 
the execudon of a piufpin. 

Instance miahlci, also known as fields, represem a pordon of an obiect*a internal stete. Each object has its 
own set of inststtce variables. Otgectt of die same dass will have die same tnstsoee variables, but each oljcct 
can have dtfoent vahws. 

Instantiation, in daect-oriented progiaroming. means to produce a particular object from its class template. 
Ihis involves allocation of a data stiucture widi the types specified by die template, and initialiattQO of 
instance variables widi eidier de&ult vahics or those provided by the class*s oonacrvctor Amedon. 

JAR ia an acronym for J ava Archive. iAR ia a pladbraHndepcndent file tbimat diat combines many files into 
one. 

Java Card Roodme ChvironoMtt (JCRE) consistt of die Java Gsrd Viraal Machine dw ftamework, and die 
associated nadvo medkods, 

JOIRI Is an acranym.fi« die lava Card 2. 1 Reference Implcmentadco. 

JCRE fimplementer refers to a peisoo creadag a vcndor^specifie iroptcmaitatiott using die Java Cu6 AM. 

JCVM U an acronym for die Java Card Virtual Machine. Ihe iCVM is die foundadoo of die OP card 
architecnire. The JCVM executes byte code and manages classes and otgccis. It enfiBroes separadoa between 
appltcadons (firewalls) and enables secure data sharing. 

JOK is an acronym Ibr Java Devdopmcat Kit The JDK is a Sun Kficrosyitcms^ Inc product dial provida die 
environment required fiir pmpanmung in Java. The JDK b available fiir a variety of platforms, but most 
notably Sun Solaris and Microsofi Windows* 

MedMd Is die oame given to a procedure or roudae, associated widi one or more clajaes, in d^ect«oriented 
languages. 

Namespace is a set of names in which all names are unique. 

ObiecUM entfd is a prDpamming mcdndology based on die ooneept of an o6/sc». which is a data sttvcnire 
enca ps u l a te d widi a set of roudnes> called methodic which operate on die data. 

Objects, hi object-oriented progrsnmng. are tniqua hutaaces of a data sinieture defined aocordhig to die 
template provided by tu class. Each ot^ct has its own vducs for die variables belonging to hs dass and can 
respond to die mcssaga (mediodiO defined by ha dass. 
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Package ts a aamespaee within the Java ^ogrammiag language lad can have elasses ud iaterfteas. A package 
It the onallest unit within the Java pregnmnuog laoguagc 

Pmtfteat object Persistoit <^ecta and tfadr values perntt from one CAD fteasioo te the oext, indefiaitely. 
Objecta are pmistcnt by de&ulu Persiatciu object vaiues are updated atomiealty using transactioDt. Hie term 
persistent does not mean there is an ob)ect«oriented database on the card or diat objectt are 
serialized/deserialtzedt Just that the olgects are not lost when the eaid loses pow^ 

Shareable Interfaee Defines a set of shared tnter&ee methods. These failerfiMe methods cat) be Invoked fiom 
one apf^et context when the <^ect implememittg diem is owned by anotficr appkt eeotesi 

Shareable Interface object <SIO) An object that implemems the shareable inter&ee. 

Tranaetlon is an atomic operatioo m which the developer defines the extmt of the operatioa by indicating in 
the program code die beginning and aid of the transaction. 

Transleat objeet The values of transient ot^ects do not persist from one CAD aesston to the next, and are reset 
to a defiiuh state at specified intervals. Updates to the vahies of transient objects are not atomic and aie not 
affected fay traosiciiaas. 
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1/5/99 12:49 PM Havnor: Stuff: jCRE D2 14DEC98: R£AD-ME*JCRE21-DF2.txt Page 1 
Date: 16 December 1998 
Dear Java Card Licensee, 

JCRE2 1 -DF2*14DEC98jeip contains a second draft of the Java Card 2.1 
Runtime Environment specification, dated December 14, 1998, for 
licensee review and comment,' We have worked incorporate and clarify 
the document based upon the review feedback we*ve received to date* 

Complete contents of the zip archive are as follows: 

R£AD-ME-JCR£21-DF2.txt • This READ ME text file 
JCR£21*DF2.pdf - ^'Java Card Runtime Environment (JCRE) 

2. 1 Spedficatton*' in PDF format 
JCRE2 1 •DF2-changebar.pdf * The revised document with change bars 

fiom previous version for ease of review. 

Summary of changes: 

1 . This is now a draft 2 release and will be published on the public web site shoitly. 

2. New description of temporary JCRE Entiy Point Objects has been introduced for purposes 
of restricting unauthorized access. 

Firewall chapter 6 J. I. 

3. Global anays now have added security related restrictions sfanilar to temporary JCRE 
Entry Point objects. Firewall chapter 

4. Detailed descriptions of the bytecodes with respect to storing restrictions for temporary 
JCRE Entry Point Objecu and 

Global anrays added. Chapter 6^.8. 

5. General statement about iCRE owned exception objects added in chapter 8. 

6. Corrected description of Virtual machine resource failures in transient factory methods. 
Chapter9.1. 

The '*Jav8 Card Runtime Environment 2.1 Specification" specifies the minimum behavior and runtime 
environment for complete Java Card 2. 1 implementation* as referred to by the Java Card APT 2. 1 and Java Card 
2.1 Virtual Machine Specification documents. This specification is required to ensure compatible operation of 
Java Card applets. The purpose of this specification document is to btiag all the JCRE elements together in a 
concise manner as part of the Java Card 2. 1 specification suite. 

Please send review comments to <jav8oem-javacard@$urtcom> or to my address as below. On behalf of the 
Java Card team, I look forward to hearing tnm you. 

Best, 

Godfrey DiGiorgi 

Godfrey DiGiorgi - godfiey.digiorgi@eng.5un.com 

OEM Licensee Engineering 

Sun Microsystems / Java Software 

+ 1 408 343-1506 - FAX -M 408 5 1 7-5460 
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What is claimed is: 

1. A small footprint device comprising: 

a. at least one processing element; 

b. memory, 

c. a context barrier using said memoiy for isolating program modules from one 
another; and 

d. a global data stmcture for permitting one program module to access 
information from another program module across said context barrier. 

2. The small footprint device of claim 1 in which said <K>ntext barrier allocates 
separate name spaces for each program module. 

3. The small footprint device of claim 2 in which at least two program modules can 
access said global data structure even though they are located in dififerent respective name 
spaces. 

4. The small footprint device of claim 1 in which said context barrier allocates 
separate memory spaces for each program module. 

5. The small footprint device of claim 4 in which at least two program modules can 
access said global data structure even though diey are located in different respective 
memory spaces. 

6. The small footprint device of claim 1 in which said context banier enforces 
security checks on at least one of a principal, an object and an action. 

7. The small footprint device of claim 6 in which at least one security check is 
based on partial name agreement between a principal and an object. 

8. The small footprint device of claim 7 in which at least one program can access 
said global data structure without said at least one security check. 

9. The small footprint device of claim 6 in which at least one security check is 
based on memory space agreemmt between a principal and an object. 
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10. The smaU footprint device of claim 9 in which at least one program can access 
a global data stnicture without said at least one security check. 

11. A method of operating a small footprint device, comprising the step of 
separating program modules using a context barrier and pcnnitting access to infonnation 
across the context barrier using a global data structure. 

12. The method of claim 1 1 in which the context barrier will not permit a principal 
to perform an action on an object unless both principal and object are part of the same 
context unless the request is for access to a global data structure. 

13. A method of permitting access to information on a small footprint device from a 
first program module to a second program module separated by a context barrier, 
comprising the step of creating a global data structure which may be accessed by at least 
two program modules. 

14. A method of communicating across a context barrier separating program 
modules on a small footprint device, comprising the steps of: 

a. creating a global data strocture; 

b. permitting at least one program module to write infonmation to said global data 

S structure; and 

c. having at least one other program module read information from said global data 

stmcture. 

15. A computer program product, comprising: 

a, a memory medium; and 

b. a computer controlling element comprising instructions for implementing a 
context barrier on a smaU footprint device and for bypassing said context barrier using a 

5 global data structure. 

16. The computer program product of claim 15 in which said medium is a carrier 

wave. 



17. A computer program product, comprising: 
a. a memory medium; and 
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b. a computer controlling element comprising instructions for separating a plurality 
of progiams on a small footprint device by nmning them in respective contexts and for 
permitting one program to access infomiation fiom another program by way of a global 
data structure. 

18. The computer program product of claim 17 in which said medium is a carrier 

wave. 

19. A carrier wave canying instmctions for implementing a global data structure 
for bypassing a context barrier on a small footprint device over a communications link. 

20. A carrier wave carrying instructions over a communications link for separating 
a plurality of programs on a small footprint device by running them in respective contexts 
and for pennitting one program to access information from another program using at least 
one global data structure. 

21. A method of transmitting code over a n^otk, comprising the step of 
transmitting a block of code from a servrer, said block of code comprising instructions for 
implementing a global data structure for bypassing a context bairier on a small footprint 
device over a communications link. 
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